Auricast Manuals· Installation Manual

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
AddressWhat it is
https://get.auricast.net/auricast-air_current_amd64.debThe current release, whatever its version
https://get.auricast.net/current.txtThe current release's version number
https://get.auricast.net/SHA256SUMSSHA-256 sums to check a download against
https://get.auricast.net/install.shThe 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

WhatWhere it matters to you
The playout program and the PlayIt Live importerRun by the service and by auricast-setup.
auricast-setupThe 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, auricastPlayout 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/auricastThe default home for the station folder, the as-aired log and backups.
/etc/auricast/air.envThe 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.