How to Install and Set Up AzuraCast on Your Own Server (August 2026)

Running your own internet radio station used to mean renting studio time and begging DJs to volunteer. Today, you can install AzuraCast on a basic VPS and be broadcasting to the world in under an hour. I have set up more than a dozen AzuraCast instances for community stations, hobby DJs, and small businesses, and the process has gotten dramatically simpler over the past few years.

This guide walks you through exactly how to install AzuraCast on your own server using the recommended Docker method. I will cover the prerequisites, every command you need to type, the first-time web setup, and the common errors I have seen trip people up. By the end you will have a working 24/7 radio station you control completely.

What Is AzuraCast and Why Self-Host Your Radio Station?

AzuraCast is a free, open-source web radio management suite that lets you run your own internet radio station from a virtual private server (VPS) or dedicated machine. It bundles the streaming server, the Auto DJ, the media library, the playlist scheduler, and the web dashboard into one self-contained package.

The project is community-driven, regularly updated, and used by everyone from bedroom DJs spinning house music to licensed community radio stations running talk shows. Because it is open source under the BSD license, you can run it for free with no per-listener fees or surprise rate limits.

How AzuraCast Works Under the Hood

AzuraCast uses Docker containers to run everything in isolation. When you run the installer, it pulls down several containers that handle different jobs: the web interface, the database, the streaming server (Icecast or Shoutcast), and a Liquidsoap engine that powers the Auto DJ. Each piece can be updated or restarted independently without taking your station offline.

Because all of these services live in containers, your host operating system stays clean. You do not have to install Icecast, Liquidsoap, MariaDB, and a web server manually and pray that none of them conflict. Docker handles the plumbing for you.

AzuraCast vs. the Alternatives

If you search for radio automation software, you will find tools like RadioBOSS, SAM Broadcaster, and Rivendell. Most of them are Windows-only desktop applications that tie your stream to a single machine. AzuraCast is different: it is server software, so your stream keeps running even when your laptop is closed.

Free hosted alternatives like Radio.co and Airtime Pro charge monthly fees once you outgrow their starter tiers. Self-hosting AzuraCast on a $5 VPS removes that recurring cost and gives you unlimited stations, unlimited listeners, and complete control over your audio chain.

Prerequisites and System Requirements

Before you install AzuraCast, make sure you have everything on this checklist. Skipping a step here is the single most common reason I see installation threads on Reddit go off the rails.

Minimum VPS Specs

AzuraCast runs comfortably on modest hardware. For a single station with up to a few hundred concurrent listeners, these are the minimums:

• 1 CPU core (2 cores recommended if you plan to run multiple stations or transcode streams)

• 1 GB RAM (2 GB strongly recommended; some VPS providers oversell RAM, so pick one with dedicated memory)

• 20 GB SSD storage (each uploaded audio track uses a few MB to a few hundred MB)

• A public IPv4 address and an unblocked TCP port (default is 80 for HTTP and 443 for HTTPS)

• Ubuntu 22.04 LTS or 24.04 LTS, Debian 12, or a recent CentOS/Rocky Linux release

What You Need Before You Start

• Root or sudo access to the server (AzuraCast needs to install Docker and bind to privileged ports)

• An SSH client on your local computer: Terminal on macOS/Linux, Windows Terminal with OpenSSH on Windows 10/11, or PuTTY on older systems

• A registered domain name pointed at your server’s IP address (optional but recommended for SSL and a clean stream URL)

• About 30 minutes of uninterrupted time for the initial install and first boot

How to Install AzuraCast on Your Own Server (Docker Method)

The official AzuraCast team recommends the Docker installation path, and so do I. It is the same on every Linux distribution, it is the easiest to update, and it is what every forum thread assumes you are running. Here is the full process from a blank server to a working station.

Step 1: Connect to Your Server via SSH

Open your terminal and connect to your VPS. Replace the placeholder with your server’s IP or hostname.

ssh root@your-server-ip

If you set up a non-root user with sudo, log in as that user instead. The installer will prompt for sudo when it needs elevated privileges. If this is your first time using SSH, accept the host key fingerprint prompt and enter your password.

Step 2: Download the Docker Utility Script

AzuraCast ships with a single helper script that installs Docker, Docker Compose, and AzuraCast itself. Download it with curl:

curl -L https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker.sh > docker.sh

Make the script executable so your shell will run it:

chmod a+x docker.sh

Step 3: Run the AzuraCast Installer

Now run the installer. It will ask for confirmation before installing Docker and pulling the AzuraCast containers.

./docker.sh install

The script handles every dependency: it installs Docker Engine, installs Docker Compose, sets up the azuracast directory in your home folder, downloads the latest AzuraCast release, and starts all of the containers. On a fresh VPS this takes 5 to 15 minutes depending on your network speed. When you see the final “Setup complete” message, the web interface is already running.

Step 4: Complete the Setup

The installer creates a default installation directory at ~/azuracast on your server. Your configuration lives in that folder, and your media uploads live inside the same directory tree. If you ever need to migrate your station, you copy that single folder to a new server.

To check that the containers are running, use:

docker ps

You should see several containers named azuracast_web, azuracast_nginx, and the database and streaming containers. If any of them show “Restarting” instead of “Up”, give them a few minutes and check again.

Unattended (Automated) Installation

If you are scripting a fleet of installations or want a fully hands-off setup, the AzuraCast team supports an unattended mode. It is the same script, just non-interactive.

yes ” | ./docker.sh install

This pipes an empty “yes” to every prompt. It is perfect for cloud-init scripts, Ansible playbooks, or Terraform deployments. I have used it to spin up identical radio stations for a network of three community stations in less than ten minutes.

Accessing the AzuraCast Web Interface

With the installer finished, open a browser and go to http://your-server-ip/. You will land on the AzuraCast welcome screen.

The first time you load the dashboard, the system asks you to create a Super Administrator account. Pick a strong password. This account has full control over every station, every user, and every setting on the server, so treat it like the root password of your VPS.

After you log in, the home screen shows an empty profile: no stations, no playlists, no media. That is normal. The next step is to create your first radio station.

Creating Your First Radio Station

AzuraCast makes the first-station workflow surprisingly painless. From the dashboard, click “Add a Station” and the setup wizard opens.

Pick a Name and a Profile

Give the station a short name and a longer description. The short name becomes part of your stream URL, so choose something URL-friendly. AzuraCast lets you pick from preset station profiles: a typical music station, a talk station, or a custom configuration. If you are unsure, the music profile is the right starting point for 90% of users.

Choose Your Streaming Protocol

AzuraCast supports both Icecast 2 and Shoutcast 1. Both are industry-standard streaming servers. Icecast is the more flexible of the two and supports multiple mount points per station, so I usually go with Icecast unless a specific listener tool only understands Shoutcast.

Upload Music and Build a Playlist

Head to the Playlists section, create a new playlist, then upload audio files through the Media Manager. AzuraCast accepts MP3, OGG, FLAC, and most common formats. After your files are uploaded, drag them into the playlist in whatever order you want them to play.

Once you assign the playlist to the station’s Auto DJ and enable it, the Liquidsoap engine takes over and starts streaming. Your station is now live.

Find Your Stream URL

The “Stream URL” button on the station profile gives you the public link to share. The default format is http://your-server-ip:8000/listen.mp3. Anyone with that URL can tune in from a browser, a mobile app, or an embedded player on their website.

Common Installation Problems and Fixes

Even with a smooth installer, things occasionally go sideways. Here are the four problems I see most often in the AzuraCast subreddit, and how I fix them.

Docker Installation Fails on Older VPS Kernels

Some cheap VPS providers ship kernels that are too old for modern Docker. If the installer hangs or returns a kernel error, update your packages and reboot before retrying.

apt update && apt upgrade -y && reboot

On CentOS/Rocky, swap apt for dnf. After the reboot, run the AzuraCast installer again.

Port 80 Already in Use

If you already run a web server like Apache or Nginx on the host, it will fight AzuraCast for port 80. Either stop and disable the conflicting service, or move AzuraCast behind a reverse proxy. For most users, stopping the other web server is the simpler path.

systemctl stop apache2 && systemctl disable apache2

Cannot Log In to the Web Interface

If the page loads but login fails, your browser is probably caching old credentials. Clear cookies for the AzuraCast domain and try again. If you forgot the super admin password, you can reset it from the command line by running the role:create-account command inside the web container.

SSL Certificate Configuration

Out of the box, AzuraCast runs on plain HTTP, which is fine for testing but a bad idea for a public stream. The cleanest fix is to point a domain at your server, then use AzuraCast’s built-in Let’s Encrypt integration under Settings > System > SSL. It requests and renews certificates automatically.

Tips for Running a Reliable 24/7 Radio Station

Once your station is live, a few small habits will keep it running smoothly for years.

Keep your host operating system and Docker updated. A monthly apt upgrade and docker pull is enough for most installs. Subscribe to the AzuraCast release notes so you know when major versions drop.

Use the Auto DJ’s built-in fall-through playlists. They prevent dead air when your main playlist runs out of tracks. If you broadcast live, configure a DJ mount point so your live source takes priority without clobbering the Auto DJ.

Back up the ~/azuracast directory regularly. That single folder contains your configuration, your database, and your media. A simple cron job that tars it up and ships it to S3 has saved more than one community radio operator I know.

Finally, monitor your stream with a public tool like Radio Garden or a simple uptime checker. You will catch outages faster than your listeners will email you about them.

Frequently Asked Questions

Conclusion

Learning how to install AzuraCast on your own server is one of those projects that gives back far more than it costs. A single afternoon of setup buys you a self-hosted radio station you control, with no monthly fees and no listener limits. If you follow the steps in this guide, you should be broadcasting inside an hour.

Once your first station is running, the next things to explore are live DJ connections, stream relay to multiple servers, and the API for connecting AzuraCast to your website or mobile app. The community on the AzuraCast Discord is friendly and helpful if you get stuck.