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β
- Debian / Ubuntu
- RHEL / Fedora / CentOS
- Alpine
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
Add the Augias RPM repository and install:
curl -1sLf 'https://dl.cloudsmith.io/public/solidworx/augias/setup.rpm.sh' | sudo -E bash
sudo dnf install augias
On CentOS 7 or RHEL 7, substitute yum for dnf.
Add the Augias Alpine repository and install:
curl -1sLf 'https://dl.cloudsmith.io/public/solidworx/augias/setup.alpine.sh' | sudo -E sh
sudo apk add augias
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.
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:
# 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β
| Path | Contents |
|---|---|
/usr/bin/augias | Binary |
/etc/augias/augias.env | Configuration |
/var/lib/augias/ | Application data |
/usr/lib/systemd/system/augias.service | systemd unit |
Updateβ
- Debian / Ubuntu
- RHEL / Fedora / CentOS
- Alpine
sudo apt update && sudo apt upgrade augias
sudo dnf update augias
sudo apk update && sudo apk upgrade augias