Deployment Overview of AzuraCast on Server¶

Prerequisites and Basic Requirements¶

The deployment of AzuraCast requires a server running the Ubuntu operating system. The installation process involves updating the system package cache and requires root privileges to create directories, download scripts, and execute the installation commands.

Operating System: Ubuntu
Privileges: Root access (sudo)
Network: Internet access is required to download the installation script and pull Docker images

File and Directory Structure¶

The application is installed in a dedicated directory structure under /var. The primary directory for the AzuraCast installation is /var/azuracast.

Main installation directory: /var/azuracast
Installation script location: /var/azuracast/docker.sh

Application Installation Process¶

The installation is performed using a shell script provided by the AzuraCast developers. The process involves downloading the script, configuring the release channel, and running the installation routine.

Update the system package cache using the apt package manager.
Create the /var/azuracast directory with permissions set to 0755.
Download the installation script from the official repository to /var/azuracast/docker.sh.
Ensure the script has executable permissions (0755).
Configure the installation to use the stable release by executing the setup command.
Run the installation script to deploy the application.

The specific commands executed during the installation are:

cd /var/azuracast
'Y' | ./docker.sh setup-release
yes '' | ./docker.sh install

Docker Containers and Their Deployment¶

AzuraCast is deployed using Docker containers. The docker.sh script handles the orchestration of these containers, including pulling the necessary images and starting the services. The installation script automates the creation of the Docker environment required for the application to function.

Starting, Stopping, and Updating¶

The docker.sh script serves as the primary interface for managing the AzuraCast services. While the initial deployment uses the install command, subsequent management of the application lifecycle (starting, stopping, and updating) is typically handled through the same script or standard Docker commands depending on the configuration established during installation.

To install the application: ./docker.sh install
To configure the release channel: ./docker.sh setup-release