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 834581e4d8
Remove postinst on cron and beanstalkd.
12 months ago
.devcontainer Refine Devcontainer setup. 1 year ago
.github Re-implement ARM64 builds. 12 months ago
.run Add testing environments from PhpStorm into repo. 1 year ago
bin Use standalone MetadataManager library. 1 year ago
config Fixes #4811 -- Fix account recovery and add a recovery URL generator CLI command. 1 year ago
frontend #4836 -- Avoid triggering toasts when window is hidden. 1 year ago
plugins Begin work on custom code plugins support. 4 years ago
resources Vue component polish; locale string deduplication. 1 year ago
src Add support for zstd backups via tzst extension. 12 months ago
templates Fixes #4811 -- Fix account recovery and add a recovery URL generator CLI command. 1 year ago
tests Make entity functions line up with propertyaccess. 1 year ago
util Remove postinst on cron and beanstalkd. 12 months ago
vendor Optimize CI testing and web dependencies (#2899) 3 years ago
web Fix OpenAPI compatibility problems. 12 months ago
.dockerignore Add back dockerignore file. 1 year ago
.editorconfig More .editorconfig tweaks for PSR-12. 1 year ago
.gitattributes Change what files are included in the distributed release archives. 4 years ago
.gitignore Update to Webpack 5 and redesign build process. 1 year ago
.gitpod.Dockerfile Fix gitpod Docker build. 1 year ago
.gitpod.yml More Gitpod fixes. 1 year ago
.phplint.yml Change cache dir for Travis. 4 years ago
.phpstorm.meta.php Implement SMTP Mail Delivery and Self-Service Password Reset (#3848) 2 years ago Update changelog. 1 year ago
Dockerfile Build Dockerize directly (for ARM64 support); add ARM64 support back. 12 months ago
LICENSE.txt Update casing on files, add with common solutions. [skip ci] 5 years ago
Makefile Fixes #4613 -- Fix minor issues with sync:run 1 year ago Add latest stable release badge. 2 years ago
ansible.cfg Ansible: Disable configuration warnings. 2 years ago Auto-generate a root password for MariaDB installs too. 1 year ago
azuracast.sample.env Implement PHP Docker Installer (#4377) 1 year ago
codeception.yml Add more functional and unit tests. 1 year ago
composer.json Part 1 of OpenAPI transition to Attributes. 12 months ago
composer.lock PHP 8.1 compatibility changes. 12 months ago
crowdin.yaml Combine frontend/backend translation files. 1 year ago
dev.env Gitpod refinement and rollback of privileged defaults. 1 year ago
docker-compose.cloudide.yml Refine Devcontainer setup. 1 year ago Add "host.docker.local" to Linux boxes for xdebug. 1 year ago
docker-compose.installer.yml Add legacy version tag to installer YML so more Compose versions can run it. 1 year ago
docker-compose.migrate.yml Expand default Docker port range to 50 stations and add instructions. 4 years ago
docker-compose.sample.yml Don't auto-remove the LetsEncrypt container; tweak restart policy. 1 year ago
docker-compose.testing.yml Avoid re-downloading Composer deps in testing by mapping vendor dir. 1 year ago Unify to a single console command location. 3 years ago #4818 -- Switch to different method to avoid orphan warnings with installer. 1 year ago #3782 -- Make Ansible update/install scripts use the same apt calls. 2 years ago
phpcs.xml System-Wide Strict Types (#4405) 1 year ago
phpstan-baseline.neon PHPStan upgrade and new baseline. 1 year ago
phpstan.neon PhpStan fixes. 12 months ago
portainer.json Create a Portainer JSON template for AzuraCast. 3 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) 5 years ago Update to PHP 8.1. 12 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