AzuraCast is a free and open source self-hosted web radio management software. This tutorial will guide you through the steps to install AzuraCast on NixOS latest version (NixOS 21.11). The installation process is straightforward, and should take no more than 30 minutes.
Before installing AzuraCast, ensure that your NixOS is up to date by running the following commands:
sudo nix-channel --update
sudo nix-env -iA nixos.{unstable,live}
sudo nixos-rebuild switch
AzuraCast requires several dependencies to be installed before it can run properly. Use the following command to install the necessary packages:
sudo nix-env -iA nixos.{git,libxml2,nginx,php-fpm,sqlite}
To download AzuraCast code, you need to clone the repository from Git. Navigate to the directory where you want to install AzuraCast, and clone the repository using the following command:
sudo git clone https://github.com/AzuraCast/AzuraCast.git .
After cloning the repository, you need to configure AzuraCast. Run the following command to copy the sample configuration files to the correct location:
sudo cp .env.sample .env
sudo cp docker-compose.sample.yml docker-compose.yml
sudo cp docker-compose.radio.sample.yml docker-compose.radio.yml
Then, open the .env
file using your preferred text editor and configure the following variables:
AZURACAST_URL
- Enter your server's public IP address or domain name.MYSQL_ROOT_PASSWORD
- Enter a strong and secure password for the MySQL root user.AZURACAST_DB_PASSWORD
- Enter a strong and secure password for the AzuraCast database.AzuraCast uses Docker containers to manage its components. Start the Docker containers using the following command:
sudo docker-compose up -d --build
After starting the Docker containers, you can access the AzuraCast installer by visiting the following URL in your web browser:
http://<your-server-ip>:8080/install
Follow the steps in the installer to complete the AzuraCast setup process.
After completing the installer, you can access the AzuraCast dashboard by visiting the following URL in your web browser:
http://<your-server-ip>
You will be prompted to enter the username and password that you set during the AzuraCast installation.
Congratulations, you have successfully installed AzuraCast on NixOS latest! You can now start creating radio stations, scheduling playlists, managing media files, and much more using AzuraCast.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!