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.
Mitch c26601161a
Merge branch 'main' into Help-Logs
2 days ago
.devcontainer Refine Devcontainer setup. 9 months ago
.github Update Crowdin Action. 2 months ago
.run Add testing environments from PhpStorm into repo. 8 months ago
bin Code quality cleanup sweep. 2 months ago
config Move from Station:help to station:logs 2 days ago
frontend Move from Station:help to station:logs 2 days ago
plugins Begin work on custom code plugins support. 4 years ago
resources API and Locale update. 4 weeks ago
src Move from Station:help to station:logs 2 days ago
templates Reduce redundant code on public player. 2 weeks ago
tests Unify feature checks; simplify station routes. 3 days ago
util #5491 -- Change dir creation syntax. 2 days ago
vendor .gitkeep permission change. 7 months ago
web Version bump! 2 weeks ago
.dockerignore Remove deps cache step. 7 months ago
.editorconfig Minor editorconfig change. 5 months ago
.gitattributes Change what files are included in the distributed release archives. 3 years ago
.gitignore Add gitignore back. 6 months ago
.gitpod.Dockerfile Fix gitpod Docker build. 9 months ago
.gitpod.yml More Gitpod fixes. 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) 1 year ago
.psysh.php Dependency update; use psysh directly. 6 months ago Update changelog. 6 days ago
Dockerfile Merge commit 'fa79a035eaa3510636839978c82ca56b5d4044fd' 1 month ago Update 4 months ago
LICENSE.txt Update casing on files, add with common solutions. [skip ci] 5 years ago
Makefile Move frontend Docker Compose file to avoid pwd confusion in new version. 2 months ago fix docker badge (#5391) 1 month ago
ansible.cfg Ansible: Disable configuration warnings. 1 year ago AzuraCast in a Single Docker Image (#5167) 4 months ago
azuracast.sample.env Allow users to debug Slim Application Errors (#5399) 1 month ago
codeception.yml Update test suites for Codeception 5.x. 4 months ago
composer.json Dependency updates. 1 week ago
composer.lock Backend dependencies update. 4 days ago
crowdin.yaml Combine frontend/backend translation files. 8 months ago
dev.env Gitpod refinement and rollback of privileged defaults. 9 months ago
docker-compose.cloudide.yml Update cloud IDE Compose file. 4 months ago Make certs readonly on dev compose. 3 weeks ago
docker-compose.frontend.yml Use $PWD for new Docker Compose format. 2 months ago
docker-compose.installer.yml Fixes #5206 -- Make stable and rolling installer commands match. 4 months ago
docker-compose.migrate.yml Update cloud IDE Compose file. 4 months ago
docker-compose.multisite.yml LetsEncrypt/Nginx Container Consolidation (#4995) 6 months ago
docker-compose.sample.yml Merge commit 'aab4a0c7b5edab1ca261a528e3407ff2f1b59297' 3 weeks ago
docker-compose.testing.yml Update cloud IDE Compose file. 4 months ago Unify to a single console command location. 2 years ago Allow direct restore from the internal Docker backups volume. 1 week ago #3782 -- Make Ansible update/install scripts use the same apt calls. 1 year ago
phpcs.xml System-Wide Strict Types (#4405) 12 months ago
phpstan-baseline.neon Code style fixes. 2 weeks ago
phpstan.neon Improve accuracy of generics. 1 month ago
portainer.json Create a Portainer JSON template for AzuraCast. 2 years ago
sample.env Allow on-the-fly setting of UID/GID for Docker container user. 1 year ago #423 -- Update Ansible compliance, build uninstaller and migrator scripts (#442) 4 years ago #5491 -- Change dir creation syntax. 2 days 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