Quick start
From download to your first account in about ten minutes, with a link to the full page for each step.
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
- Start tracking: Tracking time.
- Add email so you can send invoices.
- Enter your key in Settings, then Licence: Buying and entering a licence.
- Install the Mac app.
- Set up backups.
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.