Skip to content

Install Litebackup

One command sets up your server, and one more puts Litebackup on every machine that runs your app.

curl -fsSL https://litebackup.com/install.sh | sudo bash

Linux x86-64 and ARM for the server, plus macOS for the command line.

On your server

Run the command above on a Linux server with systemd that the internet can reach on port 443. It installs the Litebackup server as a service that keeps itself up to date, then prints a link to name your instance and finish setup in the browser.

On your app's machines

Download the litebackup command for your platform:

Linux, x86-64 (Intel or AMD)

sudo curl -fsSL -o /usr/local/bin/litebackup https://litebackup.com/pkg/cli/stable/litebackup-linux-amd64 && sudo chmod +x /usr/local/bin/litebackup

Linux, ARM (such as AWS Graviton or Ampere)

sudo curl -fsSL -o /usr/local/bin/litebackup https://litebackup.com/pkg/cli/stable/litebackup-linux-arm64 && sudo chmod +x /usr/local/bin/litebackup

macOS, Apple silicon

sudo mkdir -p /usr/local/bin && sudo curl -fsSL -o /usr/local/bin/litebackup https://litebackup.com/pkg/cli/stable/litebackup-darwin-arm64 && sudo chmod +x /usr/local/bin/litebackup

macOS, Intel

sudo mkdir -p /usr/local/bin && sudo curl -fsSL -o /usr/local/bin/litebackup https://litebackup.com/pkg/cli/stable/litebackup-darwin-amd64 && sudo chmod +x /usr/local/bin/litebackup

Not sure which? uname -m prints x86_64 for x86-64, and aarch64 or arm64 for ARM.

Join your server

On Linux, run Litebackup as a service that starts at boot, with the join token from Machines, Add machine in your console, then back up a database:

sudo litebackup install service --user app --join TOKEN@your-instance.litebackup.cloud
sudo litebackup backup /var/lib/app/main.sqlite --wait server

--user runs the service as your app's user, so files keep their owner. On macOS, join with litebackup up TOKEN@HOST instead. To manage your instance from your terminal, run litebackup admin login.

Prefer to back up from your app's code? Use the SDK for Node.js or Go.

Update or remove

Your server updates itself. sudo litebackup install cli updates a machine to the version your server runs, and sudo litebackup uninstall service removes the service.

Update your server first, then each machine.

Every release, with its checksums, is on the packages page.