---
title: Installing
url: 'https://chronoslice.app/docs/installing'
markdown: 'https://chronoslice.app/docs/installing.md'
date: '2026-11-14'
---

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

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

Docs menu

# 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. [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. [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. [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. [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. [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. [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. [7**Settings reference**Every environment variable and flag the server reads, with its default.](https://chronoslice.app/docs/installing/settings-reference)
8. [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)

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

---

## Navigation

- Parent: [Documentation](https://chronoslice.app/docs.md)
- Previous: [Getting started](https://chronoslice.app/docs/getting-started.md)
- Next: [Licence and updates](https://chronoslice.app/docs/licence-and-updates.md)
- Children:
  - [Install on Linux](https://chronoslice.app/docs/installing/install-on-linux.md)
  - [Install on macOS](https://chronoslice.app/docs/installing/install-on-macos.md)
  - [Run with Docker](https://chronoslice.app/docs/installing/run-with-docker.md)
  - [Reverse proxy and HTTPS](https://chronoslice.app/docs/installing/reverse-proxy-and-https.md)
  - [The first account](https://chronoslice.app/docs/installing/the-first-account.md)
  - [Email](https://chronoslice.app/docs/installing/email.md)
  - [Settings reference](https://chronoslice.app/docs/installing/settings-reference.md)
  - [Backups and restoring](https://chronoslice.app/docs/installing/backups-and-restoring.md)
