Our core maintainers, along with our vast community of station operators, can answer many questions you may have about our software. We also have knowledge base articles set up for common issues encountered by our users.
Your first steps should be to check these docs for any tips or pointers. Many common issues can be solved by following the instructions in our guide pages.
If you aren't sure of what is causing your issue, checking the logs can help. Not only do the system logs often explain your error in more detail, but they're essential for our developers to be able to easily diagnose and resolve your issue.
Many parts of the AzuraCast system depend on caches to speed up site performance. Sometimes, these caches can get out of
date, and they may cause errors. You can always flush all site-wide caches using one command-line script:
For Docker Installations:
./docker.sh cli cache:clear
For Ansible Installations:
php /var/azuracast/www/bin/console cache:clear
This issue is related to an out of date docker-compose version, since we use a more up to date docker-compose version it'll return these types of errors.
ERROR: Invalid interpolation format for "installer" option in service "services": "ghcr.io/azuracast/web:${AZURACAST_VERSION:-latest}"ERROR: Invalid interpolation format for "nginx_proxy" option in service "services": "ghcr.io/azuracast/nginx_proxy:${AZURACAST_VERSION:-latest}"Solution is simple, run this command. You may need to run it with sudo permissions.
./docker.sh install-docker-compose./docker.sh installIf you get this error when starting the Docker AzuraCast instance, it means that something else (some other process or server software) is already running on the same port(s) that AzuraCast is trying to reserve for itself.
There are generally two ways to resolve this:
netstat -tulpn can help you with this) and either disable the program that's currently listening, edit its configuration to change the port it listens on, or uninstall it from the server completely.Since this error is caused by the interaction of some piece of software on your host computer and the Docker daemon, we can't automatically resolve it for you, and the best way to resolve it will depend on how your server is configured and what else is running on it.
Common services that listen on ports 80 and 443 include web servers like Apache and nginx. One common port to use if you still need these services to remain online alongside AzuraCast is port 8080, which we deliberately leave open due to its common usage with other software.
This message doesn't indicate anything is wrong with your installation; it is simply Docker Compose letting you know that it defaults to an empty string if a certain environment variable isn't present. You will see these messages if you don't have LetsEncrypt configured on your server, and you can safely disregard them.
The DB crashed while using MariaDB 10.4 and was then not restarted with the same MariaDB version so that it can recover from the redo log files but was updated to 10.5 which now is not able to handle the old redo log format (in 10.5 they changed that format).
Renaming the ib_logfile0 (and if there are more ib_logfile* files those too) and then starting the db again should work.
You can find those files here: /var/lib/docker/volumes/azuracast_db_data/_data
Stop your AzuraCast via docker-compose down, then try renaming them via mv ib_logfile0 ib_logfile0.old and after that run the update again.
If you encounter an issue that you can not resolve with the documentation please refer to our guide on how to report a bug.