# Docker Utility Script

If you're using the Docker installation method to run AzuraCast, we have created a helpful utility script to perform common functions without having to type long command names.

# Download the Utility Script

If you've recently followed the Docker installation instructions, you already have the Docker Utility Script installed. The file name is docker.sh.

If you have an older installation, you can use the Docker Utility Script by running these commands inside your AzuraCast directory on your host computer:

curl -L https://raw.githubusercontent.com/AzuraCast/AzuraCast/master/docker.sh > docker.sh
chmod a+x docker.sh

# Available Commands

# Run Command Line Tools

./docker.sh cli [command_name]

Runs any command exposed by the command line interface tools.

# Install AzuraCast

./docker.sh install

Pulls the latest version of all Docker images and sets up the AzuraCast database. When complete, your AzuraCast instance should be up and running.

# Update AzuraCast

./docker.sh update-self
./docker.sh update

Note: You should always run update-self first to update the updater script.

Automatically pulls down any updated Docker images and applies any database and configuration changes since your last AzuraCast update.

# Uninstall AzuraCast

./docker.sh uninstall

Turns off and permanently deletes both the AzuraCast Docker containers and permanent volumes that store the AzuraCast database and station media.


This command will fully remove any station media, statistics and metrics, and the entire database associated with your AzuraCast instance.

# Back Up Files and Settings

./docker.sh backup [/path/to/backup.tar.gz]

Creates a .tar.gz backup copy of the media, statistics and metrics of every station, along with a copy of the full AzuraCast database. You can later restore from this same file in the event of data loss or corruption.

# Restore Files and Settings

./docker.sh restore /path/to/backup.tar.gz

Extracts a .tar.gz file previously created by this same script's backup command, copying media, statistics and metrics for each station into AzuraCast and importing the version of the database contained in the backup.


Restoring from a backup will remove any existing AzuraCast database or media that exists inside the Docker volumes.

# Set Up LetsEncrypt

./docker.sh letsencrypt-create mydomain.example.com

If you want your AzuraCast installation to support HTTPS, one of the easiest ways of accomplishing this is with Let's Encrypt, a free provider of SSL certificates.

Once you have a domain name pointed to your AzuraCast installation, you can run the command above, specify your domain name, and AzuraCast will automatically verify your domain name and update the server with the SSL certificate.


Your LetsEncrypt certificate is valid for 3 months. The web service will automatically attempt to renew certificates every night.