How to Install AzuraCast on VPS Hosting: A Step-by-Step Guide

The Ultimate Guide: How to Install AzuraCast on VPS Hosting

In the digital age, starting an internet radio station has transitioned from a complex, expensive endeavor to something accessible to anyone with a bit of technical curiosity and a Virtual Private Server (VPS). At the heart of this revolution is AzuraCast, a powerful, open-source, all-in-one web radio management suite.

AzuraCast simplifies the process of managing a radio station by providing a web-based interface that handles everything from media management and playlist scheduling to listener statistics and live broadcasting. By hosting AzuraCast on a VPS, you gain full control over your broadcasting environment, ensuring high uptime, better performance, and the ability to scale as your audience grows.

This comprehensive guide will walk you through the entire process of installing AzuraCast on a VPS, from choosing the right hardware to configuring your first live stream.

---

1. Understanding AzuraCast and the VPS Advantage

Before diving into the technical steps, it is essential to understand what AzuraCast does and why a VPS is the preferred hosting method.

What is AzuraCast?

AzuraCast is a “radio station in a box.” It bundles several complex components—including Icecast or Shoutcast (the streaming server), Liquidsoap (the automation engine), and a MariaDB database—into a single, easy-to-use package. It allows you to:

• Upload and manage music files.
• Create automated playlists with advanced logic (weighted rotation, scheduled plays).
• Manage live streamers with unique credentials.
• View real-time listener analytics.
• Provide a public-facing “Now Playing” page for your listeners.

Why Use a VPS?

While you could technically run AzuraCast on a local machine, a VPS offers several critical advantages:

• 24/7 Availability: Your station stays online even when your home computer is off.
• High Bandwidth: VPS data centers have high-speed internet connections, preventing buffering for your listeners.
• Static IP: Essential for consistent connections to your stream.
• Scalability: You can easily upgrade your RAM or CPU as your listener count increases.

---

2. Choosing the Right VPS Specifications

AzuraCast is a robust application that requires specific resources to run smoothly, especially because it uses Docker containers.

Minimum Requirements

• Operating System: Ubuntu 20.04 or 22.04 LTS (64-bit) is highly recommended.
• CPU: 2 Cores (64-bit).
• RAM: 2GB minimum (4GB+ is recommended for stations with large libraries or many listeners).
• Storage: 20GB of SSD space + enough room for your music library.
• Swap Space: At least 2GB of swap space if you are running on the minimum RAM requirements.

Recommended Providers

Several VPS providers offer reliable service for AzuraCast:

• DigitalOcean: Known for “Droplets,” easy to scale.
• Hetzner: Excellent price-to-performance ratio, particularly in Europe.
• Linode (Akamai): Robust infrastructure and great support.
• Vultr: Offers high-frequency compute options.

---

3. Preparing Your VPS

Once you have purchased your VPS and received your IP address and root password, the first step is to prepare the environment.

Accessing the Server

Open your terminal (on macOS/Linux) or use a tool like PuTTY (on Windows) to connect to your server:

ssh root@your_vps_ip

Update the System

Always start by ensuring your system packages are up to date.

sudo apt update && sudo apt upgrade -y

Install Essential Dependencies

AzuraCast primarily runs inside Docker. Before installing Docker, you need a few utility packages:

sudo apt install curl git standard-res-linux-headers -y

Setting Up Swap Space

If your VPS has 2GB of RAM or less, AzuraCast might crash during installation or high-traffic periods. Creating a swap file provides a “safety net.”

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

---

4. Installing Docker and Docker Compose

AzuraCast is designed to be installed via Docker. This ensures that all dependencies (like PHP, MariaDB, and Liquidsoap) are isolated and don’t conflict with other software on your server.

Automated Docker Installation

The easiest way to install Docker on Ubuntu is using the official convenience script:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Install Docker Compose

Docker Compose is used to manage the multiple containers that make up the AzuraCast ecosystem.

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

---

5. Installing AzuraCast

With Docker ready, we can now proceed to the AzuraCast installation. AzuraCast provides an official installer script that handles the heavy lifting.

Create the Installation Directory

It is best practice to keep AzuraCast in its own directory, typically /var/azuracast.

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

Download the Installer Script

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

Run the Installer

Execute the script to begin the setup process:

./docker.sh install

What to Expect During Installation:

1. Language Selection: Choose your preferred language.
2. Installation Type: You will likely want the “Standard” installation.
3. Docker Pulls: The script will download several hundred megabytes of Docker images. This may take 5–10 minutes depending on your VPS speed.
4. Configuration: You will be asked if you want to customize the ports. For most users, the default ports (80 for HTTP, 443 for HTTPS) are best.

Once the script finishes, it will provide a message stating that AzuraCast is running.

Windows 11: Optimizations for Windowed Games & Better Performance

Streaming Yard Alternatives: Free Unlimited Streaming Options

6. Initial Web Setup

Now that the backend is running, the rest of the configuration happens in your web browser.

1. Open your browser and navigate to http://your_vps_ip.
2. Create Super Administrator: You will be prompted to create the first user account. This account has full control over the entire system. Use a strong password.
3. System Settings: You will be asked for a “Site Name” (e.g., “Global Beats Radio”) and your “Base URL” (the domain name you plan to use).
4. Privacy Settings: Configure whether you want to collect listener IP addresses (be mindful of GDPR/CCPA regulations).

7. Configuring a Domain and SSL (HTTPS)

Running a radio station over a plain IP address is unprofessional and can cause security warnings. You should point a domain (e.g., radio.yourdomain.com) to your VPS IP address.

Pointing Your DNS

Go to your domain registrar (Namecheap, Cloudflare, Google Domains) and create an A Record:

• Type: A
• Host: radio (or @ for the root domain)
• Value: Your VPS IP Address

Enabling LetsEncrypt SSL

AzuraCast has built-in support for LetsEncrypt. Once your DNS has propagated (which can take a few minutes to an hour):

1. Log in to your AzuraCast dashboard as the Super Admin.
2. Navigate to Administration > System Settings.
3. Go to the Security tab.
4. Enter your domain name in the “Site Base URL” field (e.g., https://radio.yourdomain.com).
5. AzuraCast will automatically attempt to provision an SSL certificate.

Alternatively, you can run the setup via the terminal:

./docker.sh setup-letsencrypt

8. Creating Your First Radio Station

Now comes the fun part: setting up your station.

1. On the main dashboard, click Add Station.
2. Station Name: Give your station a name.
3. Station Description: A brief blurb about your music.
4. Station URL: This is the “slug” used in the URL (e.g., my-cool-radio).
5. Timezone: Set this correctly so your scheduled playlists run at the right time.
6. Frontend/Backend: Leave these as the default (Icecast and Liquidsoap) unless you have a specific reason to change them.

Click Save Changes. Your station is now created!

9. Managing Media and Playlists

A radio station is nothing without music. AzuraCast makes it easy to manage your library.

Uploading Music

1. Go to your Station Dashboard.
2. Click Music Files in the sidebar.
3. You can drag and drop files directly into the browser, or use the SFTP details provided in the station settings to upload large libraries via a client like FileZilla.

Creating Playlists

By default, AzuraCast creates a “General Rotation” playlist.

1. Navigate to Playlists.
2. Click Add Playlist.
3. Type:
   • Standard: Plays music based on weight (higher weight = more frequent).
   • Scheduled: Plays at specific times (e.g., “Friday Night Jazz”).
   • Once per x Songs/Minutes: Perfect for station IDs or advertisements.
4. After creating a playlist, go back to Music Files, select your songs, and click Set Playlists to assign them.

10. Live Broadcasting

While the AutoDJ (Liquidsoap) handles music when no one is live, you may want to host live shows.

Creating Streamer Accounts

1. In the Station Dashboard, go to Streamers/DJs.
2. Enable the “Streamer/DJ” functionality.
3. Create a new account with a username and password.

Connecting with Software

To go live, you need broadcasting software. Popular options include:

• BUTT (Broadcast Using This Tool): Simple, multi-platform, and free.
• Mixxx: Advanced DJ software with full mixing capabilities.
• Audio Hijack: (macOS) Great for routing professional audio.

In your software, enter the following (found in the “Streamer/DJ” section of AzuraCast):

• Server Type: Icecast 2
• Host: Your domain name
• Port: Usually 8000 or 8005 (check your station settings)
• Mount: /live
• Username: Your DJ username
• Password: Your DJ password

When you start streaming from your software, AzuraCast will automatically fade out the AutoDJ and fade in your live stream.

11. Advanced Features and Optimization

To truly master AzuraCast, you should explore its advanced capabilities.

Webhooks

AzuraCast can send notifications to external services. For example, you can set up a Discord webhook to post a message every time a new song starts playing.

• Navigate to Webhooks in the station menu.
• Choose Discord or Generic Webhook.
• Paste your URL and customize the message.

Remote Relays

If you expect thousands of listeners, a single VPS might struggle. You can set up Relays on other servers to distribute the bandwidth load. AzuraCast allows you to manage these relays from the central dashboard.

API Access

AzuraCast is “API-first.” Almost everything you see in the dashboard can be controlled via an API. This is incredibly useful if you want to build a custom mobile app or a bespoke website widget to show “Now Playing” information.

12. Maintaining Your AzuraCast Installation

Like any server software, AzuraCast requires regular maintenance.

Updating AzuraCast

The developers release updates frequently. To update your installation:

cd /var/azuracast
./docker.sh update-self
./docker.sh update

Backups

Never skip backups. AzuraCast has a built-in backup service.

1. Go to Administration > Backups.
2. Configure a local backup or connect to an S3-compatible cloud storage (like Amazon S3 or DigitalOcean Spaces).
3. Schedule backups to run daily.

Monitoring Disk Space

Music files and logs can fill up a disk quickly. Use the command df -h in your terminal regularly to check your remaining space. If you run out of space, the database may become corrupted.

13. Troubleshooting Common Issues

“The site won’t load in my browser.”

• Check if the Docker containers are running: docker ps.
• Check your VPS firewall. If you are using ufw, ensure ports 80 and 443 are open:

  sudo ufw allow 80/tcp
  sudo ufw allow 443/tcp
  

“The stream is buffering.”

• Check your CPU usage. If it’s consistently at 100%, you may need to upgrade your VPS.
• Check your bitrate. Streaming at 320kbps requires significantly more bandwidth than 128kbps.

“I can’t connect my DJ software.”

• Ensure the “Streamer/DJ” feature is enabled in the Station Settings.
• Check that the station’s ports (usually in the 8000-8050 range) are open in your VPS firewall.

Conclusion

Installing AzuraCast on a VPS is a rewarding project that gives you professional-grade control over your internet radio presence. By following this guide, you have moved from a blank server to a fully functional broadcasting platform capable of automated play, live DJing, and global reach.

The key to a successful station lies in consistent maintenance, high-quality audio curation, and engaging with your audience through the tools AzuraCast provides. Whether you are running a community news station, a 24/7 lo-fi hip-hop stream, or a professional talk radio show, AzuraCast on a VPS provides the stability and flexibility you need to succeed.

Now that your server is live, start uploading your library, set your schedules, and take your voice to the world. Happy broadcasting!