Ubuntu Installation with Ansible

This method is no longer officially supported.

Why? This is an advanced installation option for seasoned Linux server administrators. The software we install can often conflict with other software installed on your server and cause problems which are difficult to diagnose and support. We do not provide support if you install AzuraCast on a server with other software installed and that software conflicts with ours.

We get it, the word Docker scares some folks. Trust us on this, though: our Docker installation is by far the easier way of installing and maintaining AzuraCast. We include helpful scripts that even install Docker and Docker Compose for you, so it's all just one command. Updates are much faster and things are much less likely to break, even for beginners.

If you want an easier, faster installation process that is supported by our team directly, please follow our recommended installation instructions.

The Ubuntu Ansible installation method (formerly known as the "bare-metal" or "traditional" installation) is an advanced option available for those who want more complex customization options or are running on very limited hardware that can't handle the minor overhead of the Docker installation method.

Currently, the following operating systems are supported:

  • Ubuntu 16.04 "Xenial" LTS
  • Ubuntu 18.04 "Bionic" LTS

Some web hosts offer custom versions of Ubuntu that include different software repositories. These may cause compatibility issues with AzuraCast. Many VPS providers are known to work out of the box with AzuraCast (OVH, DigitalOcean, Vultr, etc), and are thus highly recommended if you plan to use the Bare-metal installer.

AzuraCast is optimized for speed and performance, and can run on very inexpensive hardware, from the Raspberry Pi 3 to the lowest-level VPSes offered by most providers.

Since AzuraCast installs its own radio tools, databases and web servers, you should always install AzuraCast on a "clean" server instance with no other web or radio software installed previously.


Execute these commands as a user with sudo permissions (or root) to set up your AzuraCast server:

sudo apt-get update 
sudo apt-get install -q -y git 
sudo mkdir -p /var/azuracast/www 
cd /var/azuracast/www 
sudo git clone https://github.com/AzuraCast/AzuraCast.git . 
sudo chmod a+x install.sh 

The installation process will take between 5 and 15 minutes, depending on your Internet connection. If you encounter an error, let us know in the Issues section.

Once the terminal-based installation is complete, you can visit your server's public IP address (http://ip.of.your.server/) to finish the web-based setup.


AzuraCast also includes a handy updater script that pulls down the latest copy of the codebase from Git, flushes the site caches and makes any necessary database updates. Run these commands as any user with sudo permissions:

cd /var/azuracast/www 
sudo chmod a+x update.sh 
sudo ./update.sh