If you run an internet radio station on AzuraCast, learning how to connect a live DJ to AzuraCast is the moment your station stops feeling like a playlist and starts feeling like a real broadcast. I set this up on my own station earlier this 2026, and the process is faster than most guides make it sound.
AzuraCast is a free, self-hosted radio management suite built on Icecast 2 and Liquidsoap. It lets you run AutoDJ rotation, hand off the stream to a live human at scheduled times, and pull stats on every listener. In this guide, I will walk you through the exact steps to get a DJ on the air, whether they use Mixxx on a laptop, BUTT on a workstation, or WebDJ straight from a Chrome tab.
Table of Contents
- What You Need Before Connecting a Live DJ to AzuraCast?
- How to Enable Streamers and DJ Accounts in AzuraCast?
- How to Connect a Live DJ to AzuraCast Using Mixxx?
- How to Connect a Live DJ to AzuraCast Using BUTT?
- How to Use WebDJ to Go Live from Your Browser?
- WebDJ vs External Software: Which Should You Choose?
- Troubleshooting Common AzuraCast Live DJ Connection Issues
- Frequently Asked Questions
- Final Thoughts
What You Need Before Connecting a Live DJ to AzuraCast?
Before you touch any settings, gather these basics. Skipping this step is the number one reason AzuraCast live DJ connections fail on the first try.
An AzuraCast station you administer (admin or super-administrator role).
The Streamers feature enabled on that station.
A DJ account with a unique username and password.
Your server hostname or public IP, plus the port AzuraCast uses (8000 by default).
Streaming software installed on the DJ’s machine: Mixxx, BUTT, VirtualDJ, or another Icecast-compatible source client.
Open firewall ports: TCP 8000 for Icecast, plus 80 and 443 for the web dashboard.
A modern browser (Chrome or Firefox) if you plan to use the WebDJ option.
If you are self-hosting AzuraCast behind a router, double-check that port 8000 is forwarded. Many community forums flag this as the silent culprit behind failed connections.
How to Enable Streamers and DJ Accounts in AzuraCast?
AzuraCast hides live DJ functionality behind a station-level toggle. You have to switch it on before any streaming software can connect.
Step 1. Log in to your AzuraCast dashboard and select the station you want to go live on.
Step 2. On the station profile page, find the section labeled Enable Streamers and toggle it on. Click Save. The station will reload with a new Streamers/DJs block on the main dashboard.
Step 3. Scroll down to the Streamers/DJ Accounts panel and click Add Streamer.
Step 4. Enter a display name, a stream username, and a strong password. This password acts as your source password and stream key combined. Treat it like a token, not a regular login.
Step 5. Click Save. You will now see the new DJ listed along with a Connect button. Click Connect to reveal the hostname, port, and mount point for that account.
Step 6. Copy those connection details and send them securely to your DJ. Most stations share them through a password manager rather than email.
How to Connect a Live DJ to AzuraCast Using Mixxx?
Mixxx is the free, open-source DJ software I recommend most often. It runs on Windows, macOS, and Linux, and it speaks Icecast natively.
Step 1. Download and install Mixxx from the official site, then open it.
Step 2. Go to Preferences then Live Broadcasting.
Step 3. Tick Enable Live Broadcasting and set the Server Type to Icecast 2.
Step 4. Fill in the connection fields using the details AzuraCast gave you:
Host: your server hostname (for example, radio.example.com).
Port: 8000.
Mount Point: /stream (or whatever your station uses, like /live).
Login: the DJ’s stream username.
Password: the source password set in step 4 above.
Step 5. Set the Stream Format to MP3 at 192 kbps to match most AzuraCast defaults, and pick a sample rate of 44100 Hz.
Step 6. Click OK, then press the broadcast toggle in the main Mixxx toolbar. When the indicator turns green, your DJ is live on the AzuraCast stream.
Tip: I always do a quick test recording before going live. Mixxx lets you record locally while you broadcast, so you get a backup in case the upstream connection drops mid-set.
How to Connect a Live DJ to AzuraCast Using BUTT?
BUTT (broadcast using this tool) is a lightweight broadcaster that many community radio stations prefer for its simplicity. The setup is similar to Mixxx but with a different menu layout.
Step 1. Install BUTT and launch it.
Step 2. Click the Settings button in the main window.
Step 3. In the Main tab, choose Icecast as the server type.
Step 4. Switch to the Icecast tab and enter your AzuraCast details: address, port 8000, mountpoint, DJ username, and source password.
Step 5. In the Audio tab, pick your audio input device (typically the same soundcard Mixxx uses for the master output).
Step 6. Click Save and Close, then hit Play in the main BUTT window to start broadcasting.
BUTT is a great choice when a remote DJ only needs to send a microphone or a simple stereo feed and does not want to manage cueing, loops, or beatmatching.
How to Use WebDJ to Go Live from Your Browser?
WebDJ is AzuraCast’s built-in browser tool. It uses your microphone and a small WebRTC connection, so a DJ can go live with zero installs.
Step 1. Open your AzuraCast dashboard and click Connect next to the DJ account you want to use.
Step 2. Pick the WebDJ option rather than downloading a connection profile.
Step 3. Allow microphone access when Chrome or Firefox prompts you. Use headphones to avoid feeding the mic back into the broadcast.
Step 4. Test your audio levels with the on-screen meter, then click Go Live.
Step 5. When you are done, click Disconnect. AzuraCast will automatically hand the stream back to AutoDJ after the configured timeout.
WebDJ is best for talk segments, live interviews, and emergency on-air moments. It is not a full DJ deck, but for spoken-word or quick mixes it works well.
WebDJ vs External Software: Which Should You Choose?
Picking between WebDJ and a full broadcasting tool comes down to what your DJ is actually doing on air.
| Feature | WebDJ | Mixxx | BUTT |
|---|---|---|---|
| Install required | No | Yes | Yes |
| Best for | Talk, interviews, quick sets | Full DJ sets with mixing | Simple stereo or mic feed |
| Audio quality | Depends on browser | Studio-grade | Studio-grade |
| Multi-deck mixing | No | Yes | No |
| Works on mobile | Limited | No | No |
| Plugin cost | Free | Free | Free |
For most station managers, Mixxx is the right default because it gives the DJ real control. Use WebDJ as a fallback when software installs are not possible.
Troubleshooting Common AzuraCast Live DJ Connection Issues
If your DJ is stuck, run through this checklist. Every issue below is one I have seen come up in the AzuraCast GitHub discussions and on Reddit.
The stream connects but no audio plays. Most often this is a sample-rate mismatch. Set both Mixxx and AzuraCast to 44100 Hz. Check that the encoder is MP3 and not AAC, which Icecast does not accept.
Connection refused on port 8000. The Icecast port is blocked at the firewall or the router. Open TCP 8000 on the server, forward it on the router, and confirm with a quick telnet test from the DJ’s machine.
AutoDJ keeps playing even after I go live. AzuraCast does not auto-kick AutoDJ. Either disconnect AutoDJ manually from the dashboard, or use the streamer disconnect feature to force a handoff. Some users prefer to disable AutoDJ before every live show.
Record Not Found error in the dashboard. This happens when a stale streamer session is still open. Restart the station from the profile page, then reconnect.
The stream drops the moment the DJ disconnects. Configure the Streamer Disconnect behavior under station settings. Most stations set it to fall back to AutoDJ after a short grace period.
WebDJ microphone is silent. Browser permissions got blocked. Re-grant mic access from the site settings icon, then refresh. Use Chrome or Firefox, since Safari can drop WebRTC audio on some Mac builds.
DJ on a different network cannot connect at all. Confirm the hostname resolves publicly, not just on the LAN. If you are using a private IP, set up a reverse proxy with a public domain and TLS.
Frequently Asked Questions
How do I connect a live DJ to AzuraCast?
Enable Streamers in the station profile, create a DJ account with a username and source password, then enter those credentials into Mixxx, BUTT, or the WebDJ page. AzuraCast gives you a hostname, port (8000), and mount point that you plug into your streaming software.
Do I need to disable AutoDJ before going live?
Not always, but it helps. AzuraCast will not auto-kick AutoDJ, so if you want a clean handoff you should disconnect AutoDJ first, then start the live broadcast. You can also configure a streamer-disconnect action that returns the stream to AutoDJ when the DJ signs off.
What streaming software works with AzuraCast?
Any Icecast 2 or Shoutcast source client works. The most popular picks are Mixxx for full DJ control, BUTT for a simple stereo or mic feed, and the built-in WebDJ for browser-based streaming. VirtualDJ, Rocket Broadcaster, and Edcast also work.
Why is my AzuraCast stream not connecting?
The three most common causes are a blocked port 8000 on the firewall, a wrong source password, and a sample-rate mismatch between your DJ software and AzuraCast. Work through each one in order, and check the Liquidsoap logs for the exact error.
Final Thoughts
Learning to connect a live DJ to AzuraCast turns your station from a passive playlist into a living broadcast. Enable Streamers, create a DJ account, paste the connection details into Mixxx or WebDJ, and you are on air. If something breaks, the troubleshooting section above covers the issues that come up most often in real AzuraCast deployments.
Spin up a test stream this week, walk through these steps once, and the next time you want a guest DJ live on your station, it will only take a couple of minutes to get them connected.