Skip to main content

Linux packages

Native packages for Debian, Ubuntu, RHEL, Fedora, CentOS, and Alpine Linux are available from the SolidInvoice repository on Cloudsmith. Installing a package sets up a systemd service, places the binary at /usr/bin/solidinvoice, and creates a dedicated service user — nothing else to configure to get started.

Install​

Add the SolidInvoice APT repository and install:

curl -1sLf 'https://dl.cloudsmith.io/public/solidworx/solidinvoice/setup.deb.sh' | sudo -E bash
sudo apt install solidinvoice
info

Packages are GPG-signed. The setup scripts configure the signing key automatically — no manual key import needed.

Start the service​

Enable and start the systemd service:

sudo systemctl enable solidinvoice --now

SolidInvoice listens on http://localhost:8765. Open that URL in your browser and finish setup with the first-run wizard.

info

The service runs over plain HTTP by default. For production, place SolidInvoice behind a reverse proxy (Nginx, Caddy, Traefik) that handles TLS termination.

Configuration​

The service reads configuration from /etc/solidinvoice/solidinvoice.env. Edit this file to change the port, set the database URL, or override any other option:

/etc/solidinvoice/solidinvoice.env
# Port to listen on (default: 8765)
#SOLIDINVOICE_PORT=8765

# Database connection string
#DATABASE_URL=mysql://user:password@localhost:3306/solidinvoice

After editing, restart the service to apply changes:

sudo systemctl restart solidinvoice

Manage the service​

sudo systemctl start solidinvoice     # start
sudo systemctl stop solidinvoice      # stop
sudo systemctl restart solidinvoice   # restart
sudo systemctl status solidinvoice    # check status
journalctl -u solidinvoice -f         # follow logs

File locations​

PathContents
/usr/bin/solidinvoiceBinary
/etc/solidinvoice/solidinvoice.envConfiguration
/var/lib/solidinvoice/Application data
/usr/lib/systemd/system/solidinvoice.servicesystemd unit

Update​

sudo apt update && sudo apt upgrade solidinvoice