Skip to main content

Linux packages

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

Install​

Add the Augias APT repository and install:

curl -1sLf 'https://dl.cloudsmith.io/public/solidworx/augias/setup.deb.sh' | sudo -E bash
sudo apt install augias
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 augias --now

Augias 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 Augias behind a reverse proxy (Nginx, Caddy, Traefik) that handles TLS termination.

Configuration​

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

/etc/augias/augias.env
# Port to listen on (default: 8765)
#AUGIAS_PORT=8765

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

After editing, restart the service to apply changes:

sudo systemctl restart augias

Manage the service​

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

File locations​

PathContents
/usr/bin/augiasBinary
/etc/augias/augias.envConfiguration
/var/lib/augias/Application data
/usr/lib/systemd/system/augias.servicesystemd unit

Update​

sudo apt update && sudo apt upgrade augias