AzuraCast is a free, open-source, all-in-one, self-hosted web radio management suite. With its fast and easy installation, you can have a web radio station up and running complete with all its software.


  • Integrates your station with social media platforms like Slack and Twitter.
  • Support remote relays that broadcast your radio signal to any remote server running on Icecast.
  • Allows upload of songs, editing metadata ad organizing songs in a folder.
  • Built-in web DJ tool
  • Setup individual DJ streamers and see who is currently streaming from your profile.
  • Role-based user management that enables access control.
  • Support Custom Branding of AzuraCast pages by use of CSS and JavaScript.
  • Supports storage Local management and on S3.

This guide will show you how to install AzuraCAST Web Radio Management Suite on Ubuntu / Debian systems.

System requirements

Minimum systems requirements are

  • A 64-bit x86 (x86_64/amd64) or ARM64 CPU
  • at least 2GB of RAM
  • 20GB or greater of hard drive space
  • Ubuntu (recommended)
  • Root user or a user with sudo access.

Install AzuraCast on Ubuntu / Debian

There are a number of ways to install Azura Cast. The most common is by use of a Virtual Private Server (VPS) on the supported partners which are Digital Ocean and Linode. You just have to have an account on both platforms and select the AzuraCast image. The VPS will provision the requirements as per how you choose them and then you will set up an administrator account. Afterward, you will create the station with default settings or configure them to fit what you want.

The other option is the stand-alone or self-hosted installation. With this type, you set up the AzuraCast on a computer and serve both your station broadcasts and its own web interface through the server’s network connection. In Ubuntu, the Docker installation method is the preferred way of installing and using AzuraCast. The good thing with the docker method is that you do not have to install docker or docker-compose beforehand as the installer tools will do that for you.

Deploy AzuraCast using Docker Container

Update your system packages

sudo apt update && sudo apt upgrade -y

Install missing dependencies.

sudo apt install curl

Create an installation directory and change to that new directory.

sudo mkdir -p /var/azuracast
cd /var/azuracast

Download the docker utility script and set it as an executable and run the installation script.

curl -fsSL >
chmod a+x

Run the script after installation.

sudo apt install -y uidmap
./ install

The installation process begins. A few prompts may appear during the installation that will require you to choose the options that you would prefer. Among them is installing docker and docker-compose. But otherwise, the installation is smooth and does not take up much time with regard to your internet speed.

[OK] AzuraCast installation complete!                                          
      Visit to complete setup.                            
*** uptime_wait exited with status 0.
2022-05-04 13:14:40 0 [Note] mysqld (initiated by: unknown): Normal shutdown
157:signal-handler (1651670080) Received SIGTERM scheduling shutdown...
2022-05-04 13:14:40 0 [Note] InnoDB: FTS optimize thread exiting.
157:M 04 May 2022 13:14:41.054 # User requested shutdown...
157:M 04 May 2022 13:14:41.054 # Redis is now ready to exit, bye bye...
2022-05-04 13:14:41 0 [Note] InnoDB: Starting shutdown...
2022-05-04 13:14:41 0 [Note] InnoDB: Dumping buffer pool(s) to /var/lib/mysql/ib_buffer_pool
2022-05-04 13:14:41 0 [Note] InnoDB: Buffer pool(s) dump completed at 220504 13:14:41
2022-05-04 13:14:41 0 [Note] InnoDB: Removed temporary tablespace data file: "./ibtmp1"
2022-05-04 13:14:41 0 [Note] InnoDB: Shutdown completed; log sequence number 1329560; transaction id 1248
2022-05-04 13:14:41 0 [Note] mysqld: Shutdown complete

*** Shutting down runit daemon (PID 152)...
*** Killing all processes...
[+] Running 1/1
 ⠿ Container azuracast  Started  

Launch AzuraCast on the Web Server

Once the installation is done. Go to http://your-IP-address and the login page appears. Create an administrator account.

Once done, This page is opened that requires you to Create a New Radio station with details like the name of the station. Don’t forget to check the Enable public page. Click on Create and Continue.

Next is to customize your AzuraCast settings. You can check the box for Enable Advanced features. Then click on Save Changes.

The AzuraCast dashboard opens as shown below.

Click on Music Files to add music.

You can do so by dragging or clicking on Select Files to add the music you want.

Once the music is uploaded, You can see them in a list and the thumbnails. We will then add the songs to a playlist so that they play automatically just like on the radio.

The green board appears as shown below to indicate the songs have been added to the playlist. Then click on Start Station.

Once you go back to the profile, You will see that a song has started playing.

If you click on the Public Page you will see the song playing.


From this guide, we have learned about AzuraCast Web Radio Management Suite which allows you to set up a radio station in quick easy steps. We have also seen how to deploy the AzuraCast on Ubuntu / Debian system. The self-hosted installation process is quick and easy.


  1. After
    “sudo mkdir -p /var/azuracast
    cd /var/azuracast”

    There is a missing “sudo” for the “curl” and “chmod” commands.


Please enter your comment!
Please enter your name here