How to install AzuraCast on a LumaDock VPS

1. Prepare the VPS

1. Deploy a new VPS from your LumaDock control panel:
   • OS: Ubuntu 22.04 LTS (64-bit)
   • Recommended: 2+ vCPU, 2 GB RAM, 20 GB+ disk
2. Access the VPS via SSH:

   ssh root@YOUR_SERVER_IP

3. Update system packages:

   apt update && apt upgrade -y

4. Set hostname (optional):

   hostnamectl set-hostname radio.yourdomain.com

2. Install Required Dependencies

AzuraCast uses Docker and Docker Compose.

apt install -y curl unzip git

Install Docker:

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

Install Docker Compose:

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

3. Install AzuraCast

1. Create installation directory:

   mkdir -p /var/azuracast && cd /var/azuracast

2. Download installer:

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

3. Run the installer:

   ./docker.sh install

   • Installation type: Standard
   • HTTP/HTTPS: Choose HTTPS if using a domain

4. Access the Web Interface

Once installation finishes, access AzuraCast at:

http://YOUR_SERVER_IP
https://YOUR_DOMAIN

On first visit, create the admin account.

5. Configure Firewall (LumaDock Control Panel)

Allow these ports:

• 80 (HTTP)
• 443 (HTTPS)
• 8000-8999 (Stream ports)

Example with UFW:

ufw allow 80
ufw allow 443
ufw allow 8000:8999/tcp
ufw enable

6. Post-Installation Steps

1. Login to AzuraCast admin panel.
2. Create your first radio station and upload music or set an external stream.
3. Enable Let's Encrypt SSL from System Settings → SSL.
4. Optionally configure backups using LumaDock backup slots.

7. Useful Commands for Support

# Update AzuraCast
cd /var/azuracast
./docker.sh update

# View logs
cd /var/azuracast
docker-compose logs -f

# Restart services
cd /var/azuracast
./docker.sh restart

# Rebuild containers
cd /var/azuracast
./docker.sh update-self
./docker.sh install

8. Troubleshooting

• If the web interface doesn’t load:

  docker ps

  Ensure containers are running.
• Check disk space:

  df -h

• Verify firewall rules in LumaDock control panel if ports are blocked.