Create the company and the first invitation
The commands run in one temporary container of the image. They need no Node, no npm and no internet on the server. They readDATABASE_URL_OWNER and TB_PUBLIC_URL from .env.
1
Create the company
The slug is a short name without spaces, and The
--name is the name people see. You can create the person right away, but it is not required: the invitation is enough.person create command also has --locale (sr-Latn or en, default sr-Latn), the display language.2
Create the invitation
<TB_PUBLIC_URL>/invite/<secret> only once (--json prints it as JSON). Only the hash is stored in the database, so a lost link cannot be shown again: run the command again and you get a new one, and the previous invitation is voided. The link is valid for 72 hours and can be used once. --admin gives the person the company admin role, without it the person is an ordinary member. The access record gets invite.create.3
Open the link and sign in
Open the link in a browser and sign in with the invited account. You end up on the My tokens and profile page, as a company admin. A sign-in provider must be set up, see Sign-in.
4
Invite everyone else from the app
You invite everyone else on the Companies and members page, with the Invite a member button. The dialog is described in People and invitations: you no longer need a command on the server.
Operator folder upload
This is for when you want to queue a folder of Markdown or text files for import, without the web page. You need three things: a domain, an upload source whose rules map the folder to that domain, and a temporary container that sees the folder.- The path of every file starts with the name of the folder you mount (
/filesgivesfiles/...), and the rules target that path:folderIdandpathare thereforefiles. ingest uploadandingest removefind the source by name, so every source of a company must have its own name. With two sources of the same name the commands stop with the errorcompany acme has 2 sources named operator.- A source without rules (or with rules for a domain that does not exist) excludes every file: the upload prints
excluded:andqueued 0 file(s). - The
workerservice indexes the queued files, no extra command is needed. Followdocker compose logs worker.
./tb admin --help. Operator actions are written to the access record as system.
Limits
- Companies are created only with the operator command, not from the app.
- The invitation is valid for 72 hours and once. The link cannot be shown again.
- This page covers only the first admin and the operator upload. People, roles and sources in the app are in the Administration tab.