Install on Raspberry Pi

SubsiMail also ships as a single static arm64 binary (musl-linked, no shared libraries to install) for a Raspberry Pi 4/5 or any other 64-bit ARM board -- no Docker needed, which matters on a Pi's limited RAM.

On a regular Intel/AMD server instead? Use the Linux (x86_64) install guide -- same steps, different binary. Not sure which you have? Run uname -m: aarch64 or arm64 means this page, x86_64 means the other one.

Download for Raspberry Pi / ARM64

Run it

Make it executable and run it from the directory where you want its data/ folder created:

chmod +x subsimail
./subsimail

./subsimail starting up and logging its listening address

By default it listens on port 3000 and stores its SQLite database at data/subsimail.db, relative to wherever you launched it from. Open http://your-pi:3000 to continue with first-run setup.

Environment variables

`PORT`	Port to listen on (default `3000`)
`DATABASE_URL`	SQLite connection string, e.g. `sqlite:///opt/subsimail/data/subsimail.db`
`RUST_LOG`	Log verbosity, e.g. `info`
`ACME_DOMAIN` / `ACME_EMAIL` / `ACME_PRODUCTION`	Optional, same automatic-HTTPS behavior as the Docker install

DATABASE_URL=sqlite:///opt/subsimail/data/subsimail.db PORT=3000 RUST_LOG=info ./subsimail

Running as a service

For anything beyond a quick test, run it under systemd so it survives reboots and crashes restart it automatically:

[Unit]
Description=SubsiMail
After=network.target

[Service]
WorkingDirectory=/opt/subsimail
ExecStart=/opt/subsimail/subsimail
Environment=DATABASE_URL=sqlite:///opt/subsimail/data/subsimail.db
Environment=PORT=3000
Restart=on-failure

[Install]
WantedBy=multi-user.target

Save that as /etc/systemd/system/subsimail.service, then:

sudo systemctl enable --now subsimail

Back Install (Linux binary) Next Install (Windows .exe)