---
title: 'Quick start'
url: 'https://chronoslice.app/docs/getting-started/quick-start'
markdown: 'https://chronoslice.app/docs/getting-started/quick-start.md'
date: '2026-11-14'
description: "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? Th…"
taxonomy:
  kb_category:
    - 'Getting started'
---

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

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

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](https://chronoslice.app/docs/getting-started/requirements) if you're not sure. Running it on a Mac or in Docker instead? Those have their own guides: [Install on macOS](https://chronoslice.app/docs/installing/install-on-macos) and [Run with Docker](https://chronoslice.app/docs/installing/run-with-docker).

## 1. Download it

Open [the download page](https://chronoslice.app/download) 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

```sh
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](https://chronoslice.app/docs/installing/install-on-linux).

## 3. Write the settings

Create `/etc/chronoslice/env` with your editor:

```ini
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](https://chronoslice.app/docs/installing/settings-reference).

## 4. Run it

Create `/etc/systemd/system/chronoslice.service` with the unit file from [Install on Linux](https://chronoslice.app/docs/installing/install-on-linux), then start it:

```sh
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:

```caddy
time.example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:7340
}
```

```sh
sudo systemctl reload caddy
```

Caddy gets the certificate by itself. Prefer nginx? See [Reverse proxy and HTTPS](https://chronoslice.app/docs/installing/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](https://chronoslice.app/docs/installing/the-first-account).

Your 30-day trial has started. See [The trial](https://chronoslice.app/docs/licence-and-updates/the-trial).

## 7. Carry on

- Start tracking: [Tracking time](https://chronoslice.app/docs/using-chronoslice/tracking-time).
- Add [email](https://chronoslice.app/docs/installing/email) so you can send invoices.
- Enter your key in **Settings**, then **Licence**: [Buying and entering a licence](https://chronoslice.app/docs/licence-and-updates/buying-and-entering-a-licence).
- Install the [Mac app](https://chronoslice.app/docs/mac-app/installing-and-signing-in).
- Set up [backups](https://chronoslice.app/docs/installing/backups-and-restoring).

## Related

- [What ChronoSlice is](https://chronoslice.app/docs/getting-started/what-is-chronoslice)
- [Tracking time](https://chronoslice.app/docs/using-chronoslice/tracking-time)
- [The menu bar timer and shortcuts](https://chronoslice.app/docs/mac-app/the-menu-bar-timer-and-shortcuts)

## 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%2Fgetting-started%2Fquick-start)[Your requests](https://chronoslice.app/help/tickets)

---

## Navigation

- Parent: [Getting started](https://chronoslice.app/docs/getting-started.md)
- Previous: [Requirements](https://chronoslice.app/docs/getting-started/requirements.md)
