---
title: 'The first account'
url: 'https://chronoslice.app/docs/installing/the-first-account'
markdown: 'https://chronoslice.app/docs/installing/the-first-account.md'
date: '2026-11-14'
description: '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 Open your ChronoSlice address. A new install shows Welcome to ChronoSlice instead of the s…'
taxonomy:
  kb_category:
    - Installing
---

[Docs](https://chronoslice.app/docs)

 [Contact support](https://chronoslice.app/help/new) 

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](https://chronoslice.app/docs/licence-and-updates/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:

```ini
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.

```sh
sudo -u chronoslice env CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db \
  chronoslice setup --email you@example.com --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 you@example.com 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](https://chronoslice.app/docs/moving-to-chronoslice/from-toggl-track).

## After setup

- Set your organization's details in **Settings**, and your letterhead under **Reports & branding**.
- Add [email](https://chronoslice.app/docs/installing/email) so ChronoSlice can send invoices.
- Enter your [licence key](https://chronoslice.app/docs/licence-and-updates/buying-and-entering-a-licence), or carry on with the trial.
- Install the [Mac app](https://chronoslice.app/docs/mac-app/installing-and-signing-in).

If you forget your password, there's no reset email. Set a new one at the server with `chronoslice user set-password`. See [Troubleshooting](https://chronoslice.app/docs/help/troubleshooting).

## Related

- [Install on macOS](https://chronoslice.app/docs/installing/install-on-macos)
- [Run with Docker](https://chronoslice.app/docs/installing/run-with-docker)
- [Install on Linux](https://chronoslice.app/docs/installing/install-on-linux)
- [The trial](https://chronoslice.app/docs/licence-and-updates/the-trial)

## 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.

 [Contact support](https://chronoslice.app/help/new?from=%2Fdocs%2Finstalling%2Fthe-first-account)[Your requests](https://chronoslice.app/help/tickets)

---

## Navigation

- Parent: [Installing](https://chronoslice.app/docs/installing.md)
- Previous: [Reverse proxy and HTTPS](https://chronoslice.app/docs/installing/reverse-proxy-and-https.md)
- Next: [Email](https://chronoslice.app/docs/installing/email.md)
