AzuraCast is a self-hosted web radio management suite, including turnkey installer tools and an easy-to-use web app to manage your stations.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Buster "Silver Eagle" Neece 65dd8f143f
Update Docker Compose if possible.
4 months ago
.devcontainer Initial developer container commit. 4 months ago
.github Run most of the CI testing as root. 4 months ago
bin Try connecting to Redis first. 5 months ago
config Add more accommodations for standalone mode. 4 months ago
frontend Add schedule embed widget for embedding the stations playlist schedule view into websites (#4323) 4 months ago
plugins Begin work on custom code plugins support. 3 years ago
resources Add resources. 4 months ago
src Merge branch 'main' into ci-testing 4 months ago
templates Add formatted connected time in listeners report (#4324) 4 months ago
tests More tests and fixing minor issues with station spinup/down. 4 months ago
util Set default permissions in other dirs. 4 months ago
vendor Optimize CI testing and web dependencies (#2899) 1 year ago
web Update to version 0.13.0. 4 months ago
.dockerignore Another attempt at fixing the CI. 4 months ago
.editorconfig Keep PhpStorm from fighting Composer on indentation. 9 months ago
.gitattributes Change what files are included in the distributed release archives. 3 years ago
.gitignore Unify env var names on Ansible installs with their Docker counterparts. 9 months ago
.phplint.yml Change cache dir for Travis. 3 years ago
.phpstorm.meta.php Implement SMTP Mail Delivery and Self-Service Password Reset (#3848) 8 months ago Update changelog. 4 months ago Update links across application to point to new documentation. 8 months ago Update links across application to point to new documentation. 8 months ago
Dockerfile Minor dockerfile updates. 4 months ago
LICENSE.txt Update casing on files, add with common solutions. [skip ci] 4 years ago Add latest stable release badge. 5 months ago Update links across application to point to new documentation. 8 months ago
ansible.cfg Ansible: Disable configuration warnings. 5 months ago Implement Podcasting Support 5 months ago
azuracast.sample.env Disable profiling extension loading by default for new rolling installs. 4 months ago
codeception.yml Add more functional and unit tests. 4 months ago
composer.json Merge branch 'main' into ci-testing 4 months ago
composer.lock Fixes #4122 -- Update getid3 library. 4 months ago
crowdin.yaml Download latest translations and run static build during CI/CD. (#2893) 1 year ago Compose updates. 4 months ago
docker-compose.migrate.yml Add the 2.2 version back to the main compose file for compatibility. 4 months ago
docker-compose.sample.yml Add the 2.2 version back to the main compose file for compatibility. 4 months ago
docker-compose.testing.yml Expressly mount composer vendor folder. 4 months ago Unify to a single console command location. 2 years ago Update Docker Compose if possible. 4 months ago #3782 -- Make Ansible update/install scripts use the same apt calls. 8 months ago
phpcs.xml Fix code styles competing between PHPCS and PhpStorm. 10 months ago
phpstan.neon Implement checkfile format exceptions for CI builds 6 months ago
portainer.json Create a Portainer JSON template for AzuraCast. 1 year ago
sample.env Add default port env vars and fix composer run command. 4 months ago #423 -- Update Ansible compliance, build uninstaller and migrator scripts (#442) 4 years ago Update MariaDB version across Ansible installs. 5 months ago

AzuraCast: A Simple, Self-Hosted Web Radio Management Suite

Build Status Latest Stable Release Apache 2.0 License Ethical Open Source Docker Pulls Twitter Follow

AzuraCast is a self-hosted, all-in-one web radio management suite. Using its easy installer and powerful but intuitive web interface, you can start up a fully working web radio station in a few quick minutes. AzuraCast works for web radio stations of all types and sizes, and is built to run on even the most affordable VPS web hosts. AzuraCast is currently beta software.

You can learn more about AzuraCast via our Documentation:

Live Demo

Want to see AzuraCast for yourself? Visit our demo site at

  • Username:
  • Password: demo

Install AzuraCast

To 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 Apache license, version 2.0. This project is free and open-source software, and pull requests are always welcome.

Need Help?

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.

Communities and Social Media

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:

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.

Friends of AzuraCast

We would like to thank the following organizations for their support of AzuraCast's ongoing development:

  • DigitalOcean for generously providing the server resources we use for our demonstration instance, our staging and testing environments, and more

  • 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

  • Netlify for supporting open-source software like ours and for serving as the host of our primary web site.

  • 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

Support AzuraCast Development

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 either of the links below. Your support is greatly appreciated.

Buy Me a Coffee at