Skip to content
AzuraCast

Install AzuraCast with Docker

AzuraCast is powered by Docker and uses pre-built images that contain every component of the software. Don’t worry if you aren’t very familiar with Docker; our easy installer tools will handle installing Docker and Docker Compose for you, and updates are very simple.

System Requirements

Please check the page with the AzuraCast system requirements before installing to make sure your server meets the minimum requirements.

Installing

Connect to the server or computer you want to install AzuraCast on via an SSH terminal. You should be an administrator user with either root access or the ability to use the sudo command. If you are not the root user, you may need to run sudo su - before executing the commands below.

Pick a base directory on your host computer that AzuraCast can use. If you’re on Linux, you can follow the steps below to use the recommended directory:

Terminal window
mkdir -p /var/azuracast
cd /var/azuracast

Use these commands to download our Docker Utility Script, set it as executable and then run the Docker installation process:

Terminal window
curl -fsSL https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker.sh > docker.sh
chmod a+x docker.sh
./docker.sh install

On-screen prompts will show you how the installation is progressing.

Troubleshooting

Some Virtual Private Server (VPS) providers sometimes ship a old version of Docker or Docker-Compose with their systems and the version isn’t fully compatible with our installation script. This can be resolved by running these commands then attempting the installation process again:

Terminal window
cd /var/azuracast
./docker.sh install-docker
./docker.sh install-docker-compose
./docker.sh install

Unattended Installation

To automate the installation process for AzuraCast, you can run the following commands or place them into a cloud-init script:

Terminal window
mkdir -p /var/azuracast
cd /var/azuracast
curl -fsSL https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker.sh > docker.sh
chmod a+x docker.sh


# To install the "Stable" release channel instead of "Rolling Release", uncomment this line:
# yes 'Y' | ./docker.sh setup-release


yes '' | ./docker.sh install