Installing The Package
Auricast is a single Debian package. Installing it puts the program in place and creates the settings file, but it does not start playing: the service waits until you finish first-time setup.
Install It
In a terminal on the box, run:
curl -fsSL https://get.auricast.net/install.sh | sudo sh
The script checks that the box is Debian 13 or newer on a 64-bit Intel or AMD processor, downloads the current release from get.auricast.net, checks it against its published SHA-256 sum, and installs it with apt, which also brings in the packages Auricast needs. If the download does not match its sum, nothing is installed.
Installing By Hand
The current release is always at a fixed address, so you can also download it yourself and install it with apt:
curl -fsSLO https://get.auricast.net/auricast-air_current_amd64.deb
sudo apt install ./auricast-air_current_amd64.deb
| Address | What it is |
|---|---|
| https://get.auricast.net/auricast-air_current_amd64.deb | The current release, whatever its version |
| https://get.auricast.net/current.txt | The current release's version number |
| https://get.auricast.net/SHA256SUMS | SHA-256 sums to check a download against |
| https://get.auricast.net/install.sh | The install script |
Each release also stays at its own name (auricast-air_<version>_amd64.deb), so a box can be put back on an earlier one.
What The Package Puts On The Box
| What | Where it matters to you |
|---|---|
| The playout program and the PlayIt Live importer | Run by the service and by auricast-setup. |
auricast-setup | The command you use for first-time setup. |
The Auricast service (auricast-air) | Plays the schedule and serves the screens. Starts at boot once you enable it. |
The mount helper (auricast-mount) | A small second service that mounts your library locations. It is enabled when the package installs. |
A system user, auricast | Playout runs as this ordinary user, a member of the audio group, and drops to it even though the service itself starts as root. |
/var/lib/auricast | The default home for the station folder, the as-aired log and backups. |
/etc/auricast/air.env | The settings file. It is written once from a template and never overwritten by an upgrade. |
The package needs libasound2t64 and a systemd of version 254 or later; both come with Debian 13.
Check That It Installed
sudo auricast-setup check
On a fresh install this reports what is not set yet and ends with not ready. That is expected. The next page walks you through each line.
Removing It
Removing the package stops the service. Your settings, station folder and stored secrets stay on the box, so installing again later picks up where you left off.