Skip to Content
FontegoDocs

Workspaces

Create workspaces from a template or a Git repository, give people roles, and archive or delete them.

Create one

A server admin creates workspaces, and becomes the new workspace's admin:

fontego workspace create handbook --name "Handbook" --description "How we work"
fontego workspace create handbook --template demo
fontego workspace create handbook --git https://example.org/handbook.git --branch main

It starts empty, from a template (fontego workspace templates lists them), or from a Git repository with its history (--no-history takes only its last version). Through the API, Git repositories must be on the public internet over https; on the server's machine, fontego-server workspace create also takes a folder, a .zip or a local repository (Install).

Files that the workspace's rules refuse, or that the source's .fontegoignore files leave out, aren't brought in, and the answer lists them.

Members

fontego members notes                              # who is in it, with their role
fontego members set notes ana@example.org editor   # reader, editor or admin
fontego members remove notes ana@example.org

The person needs an account first (People and accounts). A workspace's admins manage its members, its details (fontego workspace edit) and its protected paths.

Archive and delete

fontego admin workspaces                    # every workspace of the instance
fontego admin workspaces archive notes
fontego admin workspaces unarchive notes
fontego admin workspaces delete notes --confirm notes

An archived workspace leaves everyone's list and takes no writes: its files, description and members stay as they were, and synced folders keep their own changes until it is brought back. Only an archived workspace can be deleted, for good, with its files and history, and the command asks for its name again.

On this page