Skip to content

Staff bootstrap

The first staff account is made from the command line, against the database, without the RC tool. Later staff accounts are made in the RC tool.

Terminal window
borne-server --config server.toml admin create-account alice

It asks for the password on the terminal. Use --password-stdin to read it from a pipe in a script. Players can also create their own account on the login screen while the Server Option allowregistration is true.

Terminal window
borne-server --config server.toml admin grant-staff alice --ip "127.0.0.1,pc:123456" --rights all --folders default
Option Meaning
--ip The places the account may log in to RC from: patterns separated by commas. See using the RC tool. An empty list allows no RC login. first-login alone binds the account to the address of its first RC login
--rights all, or a comma-separated list of right names. The names are in staff rights
--folders default for the default folder rules, or another word together with --folders-file path for a file with one rule per line

The command creates the staff entry, or updates it, and brings the Server Option staff up to date. It writes to the audit log with via = 'cli'.

When the server starts with no staff account, it prints a hint with this command.

Open the RC tool, enter the server address, the account, and the password. The login works only when the account is staff, the account is not banned or disabled, and the connection matches the IP list.

When you do not know the address in advance, grant the staff entry with --ip first-login. The first RC login with the right password saves the address of that connection as the only allowed address. Logins from any other address are refused after that. To change the address later, edit the IP list of the account in the RC tool, or run grant-staff again.

The server writes the binding to the audit log as rc.ip_bound. Log in from a network you trust: whoever logs in first with the password sets the address.

The staff table is the one list of who is staff. An account cannot give a right it does not have, and cannot remove its own “Change rights”. Give all only to the people who run the server.

Engine version 0.1.0. Built 2026-11-18.