Updated: 10 November 2026 · Applies to: AzuraCast 0.24.0 (Stable channel, Docker installation; labels checked against the AzuraCast 0.24.0 source code and the official AzuraCast documentation)

As soon as ./docker.sh install finishes, open your server's IP address or domain in a browser. AzuraCast starts a three-step first-time setup wizard: Create Account (your Super Administrator login), Create Station (your first radio station) and System Settings (the site's base URL and other basics). Do this straight away: until the first account exists, anyone who opens the address can create it and take over the installation.

Where to get AzuraCast

The official AzuraCast website is azuracast.com, with the documentation under azuracast.com/docs. The source code and release notes are on GitHub. AzuraCast is free and open source; download the installer only from these places.

AzuraCast system requirements

According to the AzuraCast documentation:

  • Minimum: a 64-bit x86 (x86_64/amd64) or ARM64 CPU, at least 2 GB of RAM and 20 GB or more of disk space, on a machine that can run Docker. AzuraCast says this is the bare minimum and does not guarantee smooth running.
  • Recommended: 4 CPU cores, 4 GB of RAM and 40 GB or more of disk, which the documentation describes as enough for hobby use with about 5 to 10 stations.
  • Operating system: a fresh, minimal Ubuntu or Debian LTS installation without Docker already installed. The installer handles Docker and Docker Compose for you.
  • Not suitable: some OpenVZ or LXC containers cannot run Docker, and AzuraCast does not support Podman, so a KVM VPS or a dedicated server is the safe choice.

Your music library needs disk space on top of this, so plan storage around the size of your files.

Install AzuraCast

Log in over SSH as root (or run sudo su - first) and run the official Docker installer:

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
./docker.sh install

The installer checks your system, asks a few questions and downloads the AzuraCast images. It asks whether you want the Stable release channel (tagged versions such as 0.24.0) or Rolling Release (every new change, several times a day at times). For a radio that must stay on air, choose Stable. The full walkthrough is in How to install AzuraCast.

By default AzuraCast uses port 80 for HTTP, 443 for HTTPS, 2022 for SFTP uploads and the range 8000 to 8499 for station streams, so allow these in any firewall in front of the server.

Step 1: Create the Super Administrator account

  1. Open http://your-server-ip (or your domain) in a browser. The page shows AzuraCast First-Time Setup.
  2. Enter your E-mail Address and a long, unique Password.
  3. Click Create Account. This account has full access to the whole system, and you stay logged in for the rest of the setup.

Step 2: Create your first station

  1. On Create a New Radio Station, fill in the Profile tab: the station Name, a Description, Genre and Time Zone (scheduled playlists follow this time zone).
  2. Leave URL Stub blank to have AzuraCast build it from the name, or set a short name now, since it becomes part of the public page and stream addresses. See how to change the station name in the AzuraCast URL.
  3. On the broadcasting tab, keep the default Local Broadcasting Service (Icecast) unless you have a reason to change it. To use Shoutcast instead, an administrator first installs it under Administration > Shoutcast 2 DNAS.
  4. Click Create and Continue. You can edit every one of these details later.

Step 3: Review the system settings

The last screen, Customize AzuraCast Settings, is the same page you later find under Administration > System Settings. Check these before you click Save and Continue:

  • Site Base URL (Settings tab): the address listeners and players use. Enter your domain (for example https://radio.example.com) if you have one, otherwise the server's IP address.
  • AzuraCast Instance Name: an optional label shown next to the logo, useful if you run more than one server.
  • Use Web Proxy for Radio: when on, streams are served through ports 80 and 443 (addresses like /listen/station_name/radio.mp3) instead of the station's own port. AzuraCast says to enable it if you use a service like Cloudflare or play your stations over SSL.
  • Release Channel (Services tab): Stable or Rolling Release, as chosen during install.

Recommended next steps

  1. Enable HTTPS. Point a domain at the server, then in Administration > System Settings > Services, fill in the LetsEncrypt domain name and email and click Save Changes, then Generate/Renew Certificate. After it works, turn on Always Use HTTPS on the Security & Privacy tab. See the conditions for Let's Encrypt with AzuraCast and how to enable it.
  2. Set up email. Under Services > E-mail Delivery Service, add your SMTP details and click Send Test Message. Without it, the "Forgot Password" link cannot send anything.
  3. Add users with only the rights they need instead of sharing the Super Administrator login: see create a station, a user and assign permissions.
  4. Upload music and build playlists so the AutoDJ has something to play: see add and set up a new playlist.
  5. Plan backups under Administration > Backups, ideally to storage off the server.

Keep AzuraCast updated

Update from the web panel (Administration > Update AzuraCast) or over SSH:

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

Stations go briefly off air during an update, so pick a quiet time. To switch release channel later, run ./docker.sh setup-release and then update. AzuraCast advises a backup before switching, and warns against moving from Rolling Release to an older Stable version.

If you would rather skip the server work, Ucartz AzuraCast hosting is set up by our team, including the steps above.

Official documentation: AzuraCast requirements, Install AzuraCast with Docker, Release channels.

Was this answer helpful?

Still stuck? Open a ticket