---
title: Documentation
url: 'https://chronoslice.app/docs'
markdown: 'https://chronoslice.app/docs.md'
date: '2026-11-14'
description: 'How to put ChronoSlice on your own server, keep it licensed and up to date, and use it day to day in the web app and on your Mac.'
---

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

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

Docs menu

# Documentation

How to put ChronoSlice on your own server, keep it licensed and up to date, and use it day to day in the web app and on your Mac.

## [Getting started](https://chronoslice.app/docs/getting-started)

What ChronoSlice is, what you need to run it, and how to get from download to your first account.

1. [**What ChronoSlice is**The server, the web app and the Mac app, what they do together, and what ChronoSlice leaves out.](https://chronoslice.app/docs/getting-started/what-is-chronoslice)
2. [**Requirements**What you need before you install: a Linux or Mac server, or Docker, a domain with HTTPS, and optionally email and Stripe.](https://chronoslice.app/docs/getting-started/requirements)
3. [**Quick start**From download to your first account in about ten minutes, with a link to the full page for each step.](https://chronoslice.app/docs/getting-started/quick-start)

## [Installing](https://chronoslice.app/docs/installing)

Put ChronoSlice on a Linux server, a Mac or Docker, put HTTPS in front of it, set up the first account and email, and back it up.

1. [**Install on Linux**Put the ChronoSlice binary on a Linux server, give it a user, a data folder and a settings file, and run it with systemd.](https://chronoslice.app/docs/installing/install-on-linux)
2. [**Install on macOS**Put the ChronoSlice binary on a Mac that stays on, give it a data folder and a settings file, and run it as a launchd daemon.](https://chronoslice.app/docs/installing/install-on-macos)
3. [**Run with Docker**Run ChronoSlice from its Docker image with Docker Compose, keep the data in a volume or a folder, and update by pulling the new image.](https://chronoslice.app/docs/installing/run-with-docker)
4. [**Reverse proxy and HTTPS**Serve ChronoSlice over HTTPS with Caddy or nginx, and set the two settings that go with it.](https://chronoslice.app/docs/installing/reverse-proxy-and-https)
5. [**The first account**Create the owner account from the setup page or the command line, and protect setup with a token.](https://chronoslice.app/docs/installing/the-first-account)
6. [**Email**Connect ChronoSlice to an SMTP account so it can send invoices, reminders and receipts, and test it first with files.](https://chronoslice.app/docs/installing/email)
7. [**Settings reference**Every environment variable and flag the server reads, with its default.](https://chronoslice.app/docs/installing/settings-reference)
8. [**Backups and restoring**Back up the one SQLite file safely, use the backups that updates make, stream changes with Litestream, and restore.](https://chronoslice.app/docs/installing/backups-and-restoring)

## [Licence and updates](https://chronoslice.app/docs/licence-and-updates)

The trial, entering and moving your key, updating the server, and what happens when updates end.

1. [**The trial**Thirty days with every feature and up to five users, then what changes when the server goes read-only.](https://chronoslice.app/docs/licence-and-updates/the-trial)
2. [**Buying and entering a licence**The three editions, where your key comes from, how to enter it, and what the server tells the store.](https://chronoslice.app/docs/licence-and-updates/buying-and-entering-a-licence)
3. [**Moving to another server**Give the key's seat back on the old server, then enter the key on the new one.](https://chronoslice.app/docs/licence-and-updates/moving-to-another-server)
4. [**Updating**Install the newest release your licence covers with one command on Linux or macOS, pull the new image on Docker, and what the command does step by step.](https://chronoslice.app/docs/licence-and-updates/updating)
5. [**Renewing and upgrading**Add a year of updates, or move up an edition, from your account, and how the server finds out.](https://chronoslice.app/docs/licence-and-updates/renewing-and-upgrading)
6. [**When updates end**Your licence never expires, but a release dated after your updates ended won't start. What that means and what to do.](https://chronoslice.app/docs/licence-and-updates/when-updates-end)

## [Using ChronoSlice](https://chronoslice.app/docs/using-chronoslice)

Track time, organize clients and projects, run reports, send invoices and get paid.

1. [**Tracking time**Start a timer, log time you already worked, use the one-line quick entry, and edit your week in the timesheet and calendar.](https://chronoslice.app/docs/using-chronoslice/tracking-time)
2. [**Clients, projects, tasks and tags**Set up who the work is for, what it is, and how it is billed, including how hourly rates cascade.](https://chronoslice.app/docs/using-chronoslice/clients-projects-tasks-and-tags)
3. [**People and roles**What owners, admins, managers and members can do, how to deactivate people, and how your edition limits active users.](https://chronoslice.app/docs/using-chronoslice/people-and-roles)
4. [**Reports**Filter and group your time, round it, save reports, share them with a link, and export PDF or CSV.](https://chronoslice.app/docs/using-chronoslice/reports)
5. [**Invoices**Make an invoice from tracked time, edit its lines, number it, send it, share it with the client, and void it.](https://chronoslice.app/docs/using-chronoslice/invoices)
6. [**Recurring invoices**Bill hosting, retainers and renewals on a schedule, with the wording filled in for each period.](https://chronoslice.app/docs/using-chronoslice/recurring-invoices)
7. [**Getting paid with Stripe**Connect Stripe so clients pay an invoice online by card or US bank account, and charge saved payment methods.](https://chronoslice.app/docs/using-chronoslice/getting-paid-with-stripe)
8. [**Reminders and notifications**Reminders before and after an invoice is due, receipts, block alerts, and the other emails ChronoSlice sends.](https://chronoslice.app/docs/using-chronoslice/reminders-and-notifications)
9. [**Support hour blocks**Sell prepaid blocks of hours, draw them down as you track time, warn clients and yourself, and show clients where they stand.](https://chronoslice.app/docs/using-chronoslice/support-hour-blocks)
10. [**API tokens**Make a token for a script or app, call the HTTP API with it, and find the OpenAPI document.](https://chronoslice.app/docs/using-chronoslice/api-tokens)

## [Mac app](https://chronoslice.app/docs/mac-app)

The free menu bar timer and the Day, Week and Calendar views, with offline sync.

1. [**Installing and signing in**Install the free Mac app, point it at your server, and sign in. What it keeps on your Mac, and how to sign out.](https://chronoslice.app/docs/mac-app/installing-and-signing-in)
2. [**The menu bar timer and shortcuts**Start and stop a timer from the menu bar, the global shortcut, quick entry, and every keyboard shortcut.](https://chronoslice.app/docs/mac-app/the-menu-bar-timer-and-shortcuts)
3. [**Day, Week and Calendar**The three views in the Mac app's main window: edit a day beside its timeline, type hours into a week, and drag entries on a calendar.](https://chronoslice.app/docs/mac-app/day-week-and-calendar)
4. [**Working offline and sync**How the Mac app keeps a local copy, syncs with your server, and handles changes the server refuses.](https://chronoslice.app/docs/mac-app/working-offline-and-sync)
5. [**When the server is read-only**What the Mac app shows and does when the trial has ended, and how it recovers once a licence is entered.](https://chronoslice.app/docs/mac-app/when-the-server-is-read-only)

## [Moving to ChronoSlice](https://chronoslice.app/docs/moving-to-chronoslice)

Bring your history from Toggl Track or Square with the importers.

1. [**From Toggl Track**Import your clients, projects, tags, rates and every time entry from Toggl Track, check the totals, and switch over.](https://chronoslice.app/docs/moving-to-chronoslice/from-toggl-track)
2. [**From Square**Import customers, invoices with their payments and fees, and recurring invoices from Square, without billing anyone twice.](https://chronoslice.app/docs/moving-to-chronoslice/from-square)

## [Help](https://chronoslice.app/docs/help)

Fixes for common problems, and every command the server understands.

1. [**Troubleshooting**Fixes for a server that won't start, a licence the store can't reach, email that doesn't send, a read-only server, and a Mac app that won't sync.](https://chronoslice.app/docs/help/troubleshooting)
2. [**Command reference**Every chronoslice command and flag, with defaults and examples.](https://chronoslice.app/docs/help/command-reference)

## 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)[Your requests](https://chronoslice.app/help/tickets)

---

## Navigation

- Previous: [Privacy Policy](https://chronoslice.app/privacy.md)
- Next: [Support](https://chronoslice.app/help.md)
- Children:
  - [Getting started](https://chronoslice.app/docs/getting-started.md)
  - [Installing](https://chronoslice.app/docs/installing.md)
  - [Licence and updates](https://chronoslice.app/docs/licence-and-updates.md)
  - [Using ChronoSlice](https://chronoslice.app/docs/using-chronoslice.md)
  - [Mac app](https://chronoslice.app/docs/mac-app.md)
  - [Moving to ChronoSlice](https://chronoslice.app/docs/moving-to-chronoslice.md)
  - [Help](https://chronoslice.app/docs/help.md)
