Deployment Overview of AzuraCast on Server¶

Prerequisites and Basic Requirements¶

To ensure the successful deployment and operation of AzuraCast, the following requirements must be met:

• Operating System: Ubuntu

• Privileges: Root or sudo access is required for package updates and directory management.

• Network/Ports: The server must have outbound internet access to download installation scripts and Docker images.

FQDN of the final panel on the hostkey.in domain¶

The application is accessible via a subdomain generated based on the server's unique identifier within the hostkey.in zone.

Application installation process¶

The application is installed using a specialized deployment script provided by the AzuraCast developers. The process follows these steps:

1. System Preparation: The package manager cache is updated to ensure all dependencies are current.

2. Directory Setup: A dedicated directory /var/azuracast is created to house the application files and configuration.

3. Script Acquisition: The official AzuraCast installation script (docker.sh) is downloaded from the official repository and stored in /var/azuracast.

4. Release Configuration: The installation script is configured to use the stable release branch via the setup-release command.

5. Automated Installation: The application is deployed using the install command within the setup script, which automates the container orchestration and environment setup.

Custom Scripts and Additional Setup¶

The deployment utilizes several automated actions to finalize the server state:

• Installation Script: The /var/azuracast/docker.sh script is used for both initial configuration (switching to stable release) and the core installation process.

• Environment Configuration: Post-installation tasks are performed to register the application URL and ensure the web panel is correctly tagged in the management system.

Application Update Instructions¶

To update the AzuraCast application, the deployment script should be re-run to pull the latest stable versions of the containers:

1. Navigate to the application directory:

   cd /var/azuracast
   

2. Execute the installation command to refresh the environment and update services:

   ./docker.sh install
   

Location of configuration files and data¶

All application-related data and configurations are centralized in the following location:

• Application Root: /var/azuracast

Available ports for connection¶

The application utilizes Docker containers to manage services. While specific port mappings depend on the internal container configuration, the web interface is typically accessible via standard HTTP/HTTPS ports once the proxy and SSL are configured.