Docs Contact support
Docs menu

Quick start

From download to your first account in about ten minutes, with a link to the full page for each step.

Updated Nov 14, 2026 2 min read

This page gets a ChronoSlice server running and your first account created in about ten minutes. Each step is short and links to the full page. This page uses a Linux server with sudo, and a domain name pointed at it. See Requirements if you're not sure. Running it on a Mac or in Docker instead? Those have their own guides: Install on macOS and Run with Docker.

1. Download it

Open the download page and download the Linux build for your server. Run uname -m on the server: x86_64 means the x86_64 build, and aarch64 means the arm64 build. The trial build is the same download. Copy the file to the server.

2. Install the program

tar -xzf chronoslice-0.1.0-linux-x86_64.tar.gz
sudo install -m 755 chronoslice-0.1.0-linux-x86_64/chronoslice /usr/local/bin/chronoslice
sudo useradd --system --home /var/lib/chronoslice --shell /usr/sbin/nologin chronoslice
sudo mkdir -p /var/lib/chronoslice /etc/chronoslice
sudo chown chronoslice:chronoslice /var/lib/chronoslice

Use your own version in the file names. More in Install on Linux.

3. Write the settings

Create /etc/chronoslice/env with your editor:

CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db
CHRONOSLICE_BIND=127.0.0.1:7340
CHRONOSLICE_PUBLIC_URL=https://time.example.com
CHRONOSLICE_SECURE_COOKIES=true
CHRONOSLICE_SETUP_TOKEN=paste-a-long-random-string-here

Replace the address with yours, and make the token with openssl rand -hex 24. Then run sudo chmod 600 /etc/chronoslice/env. Every setting is in Settings reference.

4. Run it

Create /etc/systemd/system/chronoslice.service with the unit file from Install on Linux, then start it:

sudo systemctl daemon-reload
sudo systemctl enable --now chronoslice
journalctl -u chronoslice -f

You should see listening on http://127.0.0.1:7340.

5. Add HTTPS

With Caddy installed, put this in /etc/caddy/Caddyfile and reload it:

time.example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:7340
}
sudo systemctl reload caddy

Caddy gets the certificate by itself. Prefer nginx? See Reverse proxy and HTTPS.

6. Create your account

Open your address in a browser. ChronoSlice shows Welcome to ChronoSlice. Fill in your name, email and password, your organization's name, timezone, currency and week start, and the setup token. Submit it, and you're the owner, signed in. See The first account.

Your 30-day trial has started. See The trial.

7. Carry on

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.