Docs Contact support
Docs menu

The first account

Create the owner account from the setup page or the command line, and protect setup with a token.

Updated Nov 14, 2026 3 min read

A new ChronoSlice install has no accounts. This page shows how to create the first one, which becomes the owner of your organization, and how to stop anyone else from doing it first.

Create it in the browser

  1. Open your ChronoSlice address. A new install shows Welcome to ChronoSlice instead of the sign-in page.
  2. Under You, enter your name, your email and a password of at least 10 characters. You sign in with the email.
  3. Under Your organization, enter its name, such as your studio or company, then its timezone, currency and the day the week starts on. The currency defaults to USD and the week to Monday. You can change all of these later in Settings.
  4. If the server has a setup token, enter it under Setup token.
  5. Submit the form. You become the owner of the organization, and you're signed in.

Setup works only while the database has no accounts. After the first one exists, the setup page and the setup request are closed for good.

The first account also starts the 30-day trial. See The trial.

Protect setup with a token

Until the first account exists, anyone who can reach the server can create it. The log says so every time the server starts, with a line that begins no accounts yet. You have two ways to be safe.

  • Finish setup right after the first start, before anyone else could find the address.
  • Set a setup token in /etc/chronoslice/env before the first start:
CHRONOSLICE_SETUP_TOKEN=paste-a-long-random-string-here

Make the value with openssl rand -hex 24, or any long random string. The setup page then asks for it, and setup is refused without it. After 10 wrong tokens in 15 minutes the server stops checking tokens until the 15 minutes pass. Restarting the service clears that count.

Once you're set up, the token does nothing, so you can take it out of the file.

Create it from the command line

chronoslice setup does the same as the setup page, without a browser. It refuses if the database already has an account. The service should be running first, so the database exists and belongs to the chronoslice user.

sudo -u chronoslice env CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db \
  chronoslice setup --email [email protected] --name "Your Name" --org "Your Studio" \
  --timezone America/Denver --currency USD --week-start monday

It asks for the password. To give it without a prompt, set CHRONOSLICE_PASSWORD, or pipe it in on the first line of standard input. The command line doesn't use the setup token, because it already needs access to the server.

  • --timezone takes an IANA timezone name such as America/Denver or Europe/London.
  • --currency takes a three-letter code and defaults to USD.
  • --week-start takes a day's name, or 0 (Sunday) to 6 (Saturday), and defaults to monday.

When it finishes it prints Set up Your Studio with [email protected] as its owner., and you sign in with that email in the web app.

Moving from Toggl Track?

You can skip setup. The Toggl importer creates your account and organization from your Toggl workspace. If you set up first and import afterwards, use the same email as your Toggl account. See From Toggl Track.

After setup

  • Set your organization's details in Settings, and your letterhead under Reports & branding.
  • Add email so ChronoSlice can send invoices.
  • Enter your licence key, or carry on with the trial.
  • Install the Mac app.

If you forget your password, there's no reset email. Set a new one at the server with chronoslice user set-password. See Troubleshooting.

Was this helpful?

Still stuck?

Send us a request: it goes to the people who build ChronoSlice, and the reply comes by email. Include your ChronoSlice version (Settings › Licence shows it) and what you tried.