A self-hosted web radio management suite, including turnkey installer tools for the full radio software stack and a modern, easy-to-use web app to manage your s
A self-hosted web radio management suite, including turnkey installer tools for the full radio software stack and a modern, easy-to-use web app to manage your s
AzuraCast is an Internet radio station "in a box"; it is a full-featured, self-contained and self-hostable software suite, distributed using Docker, that contains a full free and open-source web radio software stack and a powerful but intuitive and accessible web interface (and well-documented API) to manage your stations.
You can learn more about AzuraCast via our Documentation:
AzuraCast is built and maintained by passionate human beings, and 100% of our code is reviewed and approved by humans. We do not allow AI to replace our role as software designers or developers, nor do we permit "vibe-coded" contributions. See our policy on generative AI for more details.
Want to see AzuraCast for yourself? Visit our demo site at demo.azuracast.com:
[email protected]demoTo install AzuraCast, you should have a basic understanding of the Linux shell terminal. Once installed, every aspect of your radio station can be managed via AzuraCast's web interface.
Follow our installation guide for instructions on how to install AzuraCast on your own server.
AzuraCast is licensed under the Affero GNU General Public License (AGPL) version 3.0. This project is free and open-source software, and pull requests are always welcome.
If you need help with AzuraCast, the first place you should visit is our Support page, which features solutions to a number of commonly encountered issues and questions, as well as instructions on how to check your server's log files for more details. If you do need our help via GitHub, supplying these logs is absolutely essential in helping us diagnose and resolve your issue.
New feature requests are powered by FeatureUpvote. You can visit our Feature Request Page to submit a new feature request or vote on existing ones.
For bug and error reports, we rely exclusively on our GitHub Issues board to diagnose, track and update these reports. First, check to make sure the issue you're experiencing isn't already reported on GitHub. If it is, you can subscribe to the existing ticket for updates on the issue's progress. If your issue or request isn't already reported, click the "New Issue" button to create it. Make sure to follow the template provided, as it asks important details that are very important to our team.
Please keep in mind that AzuraCast is a free software project built and maintained by volunteers, so there may be some delays in getting back to you. We will make the absolute best effort possible to resolve your issues and answer your questions.
We frequently post to social media any time there are significant updates to our software, security issues that users should be aware of, or upcoming changes to third-party software. You can get these updates in a more timely fashion by following our accounts:
On BlueSky at @azuracast.com
On Mastodon at @[email protected]
If you are an AzuraCast user, station owner, developer or other contributor, you can also join our Discord community, where you can ask questions, share your station and more:
Note that our social media channels aren't the best way to report issues to us; instead, you should use the GitHub issues instructions above, as this allows our whole team to help resolve and track the progress of the issue in one location.
We would like to thank the following organizations for their support of AzuraCast's ongoing development:
JetBrains for making our development faster, easier and more productive with tools like PhpStorm
CrowdIn for giving us a simple and powerful tool to help translate our application for users around the world
BrowserStack for giving us tools to help test our software's accessibility and features across multiple browsers and operating systems.
Depot for powering our Docker image builds.
The creators and maintainers of the many free and open-source tools that AzuraCast is built on, who have done so much to help move FOSS forward
AzuraCast will always be available free of charge, but if you find the software useful and would like to support the project's lead developer, visit our Donate to AzuraCast page. Your support is greatly appreciated.
Circular DI dependency in StationQueueRepository/StationPlaylistRepository/StationPlaylistMediaRepository breaks AutoDJ, DJ auth, and instance boot after update
The setup process fails when trying to update to the current Rolling Release
Relay Stream URL in Mount Point does not generate <port> tag in Icecast configuration, causing connection to wrong port
[Playlist Group / Clockwheels] Feedback Thread
Jingles playlist doesn't work
cURL error 7: Failed to connect to 127.0.0.1
Add Easypanel one-click installer to installation docs
General Rotation playlists replay the same daily sequence — Reshuffle/Clear Queue don't fix it, only a config reload temporarily helps
Saving media metadata destroys every file tag AzuraCast does not manage (ReplayGain, MusicBrainz, dates) — silent data loss
Silence on auto-dj