All apps · 0 apps
AzuraRelay
Docker app from grtgbln's Repository
Overview
Readme
View on GitHub
AzuraRelay: AzuraCast's Lightweight, Automated Relay Companion
A "relay in a box" containing a lightweight web application and Icecast servers that can connect to and relay an AzuraRelay parent instance.
What it Does
After you finish the initial setup, AzuraRelay will:
- Connect to a parent AzuraCast instance and list all relayable streams,
- Automatically relay those streams via Icecast using the same ports and URLs as the parent installation, and
- Report itself back to AzuraCast so listeners can select it as a stream and you can view listener data from it.
Parent Installation Requirements
Before installing AzuraRelay, make sure your "parent" AzuraCast installation:
- Is updated to the latest version, and
- Has the direct radio ports (i.e. 8000, 8010) exposed; if you use a service like Cloudflare to protect your server, enter the server's direct IP address when prompted for the parent URL in the AzuraRelay setup.
Installing
AzuraRelay is powered by Docker and uses pre-built images that contain every component of the software. Don't worry if you aren't very familiar with Docker; our easy installer tools will handle installing Docker and Docker Compose for you, and updates are very simple.
System Requirements
- A 64-bit x86 (x86_64) CPU or ARM64 CPU (like the Raspberry Pi 3/4)
- 512MB or greater of RAM
- 10GB or greater of hard drive space
For Linux hosts, the sudo, curl and git packages should be installed before installing. Most Linux distributions include these packages already.
Installing
Connect to the server or computer you want to install AzuraRelay on via an SSH terminal. You should be an administrator user with either root access or the ability to use the sudo command.
Pick a base directory on your host computer that AzuraRelay can use. If you're on Linux, you can follow the steps below to use the recommended directory:
mkdir -p /var/azurarelay
cd /var/azurarelay
Use these commands to download our Docker Utility Script, set it as executable and then run the Docker installation process:
curl -L https://raw.githubusercontent.com/AzuraCast/AzuraRelay/main/docker.sh > docker.sh
chmod a+x docker.sh
./docker.sh install
On-screen prompts will show you how the installation is progressing.
Updating
Using the included Docker utility script, updating is as simple as running:
./docker.sh update-self
./docker.sh update
Install AzuraRelay on Unraid in a few clicks.
Find AzuraRelay in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.
Requirements
AzuraRelay supports relaying up to 50 stations.
Out of the box, this template is configured to consume ports every tenth port between 8000 and 8490 (e.g. 8000, 8010, 8020, etc.).
Azuracast works best with a 1:1 mapping of internal and external ports, so it is recommended to use this 8000-8490 range for the relay ports.
You can simply remove any ports you don't need from the template, starting with the highest port number and working down.
Related apps
Explore more like this
Explore allDetails
ghcr.io/azuracast/relay:latestRuntime arguments
- Network
bridge- Privileged
- false
Template configuration
HTTP port
- Target
- 80
- Default
- 1080
- Value
- 1080
HTTPS port
- Target
- 443
- Default
- 1443
- Value
- 1443
Optional, LetsEncrypt host
- Target
- LETSENCRYPT_HOST
Optional, LetsEncrypt email
- Target
- LETSENCRYPT_EMAIL
Station 1 port
- Target
- 8000
- Default
- 8000
- Value
- 8000
Station 2 port
- Target
- 8010
- Default
- 8010
- Value
- 8010
Station 3 port
- Target
- 8020
- Default
- 8020
- Value
- 8020
Station 4 port
- Target
- 8030
- Default
- 8030
- Value
- 8030
Station 5 port
- Target
- 8040
- Default
- 8040
- Value
- 8040
Station 6 port
- Target
- 8050
- Default
- 8050
- Value
- 8050
Station 7 port
- Target
- 8060
- Default
- 8060
- Value
- 8060
Station 8 port
- Target
- 8070
- Default
- 8070
- Value
- 8070
Station 9 port
- Target
- 8080
- Default
- 8080
- Value
- 8080
Station 10 port
- Target
- 8090
- Default
- 8090
- Value
- 8090
Station 11 port
- Target
- 8100
- Default
- 8100
- Value
- 8100
Station 12 port
- Target
- 8110
- Default
- 8110
- Value
- 8110
Station 13 port
- Target
- 8120
- Default
- 8120
- Value
- 8120
Station 14 port
- Target
- 8130
- Default
- 8130
- Value
- 8130
Station 15 port
- Target
- 8140
- Default
- 8140
- Value
- 8140
Station 16 port
- Target
- 8150
- Default
- 8150
- Value
- 8150
Station 17 port
- Target
- 8160
- Default
- 8160
- Value
- 8160
Station 18 port
- Target
- 8170
- Default
- 8170
- Value
- 8170
Station 19 port
- Target
- 8180
- Default
- 8180
- Value
- 8180
Station 20 port
- Target
- 8190
- Default
- 8190
- Value
- 8190
Station 21 port
- Target
- 8200
- Default
- 8200
- Value
- 8200
Station 22 port
- Target
- 8210
- Default
- 8210
- Value
- 8210
Station 23 port
- Target
- 8220
- Default
- 8220
- Value
- 8220
Station 24 port
- Target
- 8230
- Default
- 8230
- Value
- 8230
Station 25 port
- Target
- 8240
- Default
- 8240
- Value
- 8240
Station 26 port
- Target
- 8250
- Default
- 8250
- Value
- 8250
Station 27 port
- Target
- 8260
- Default
- 8260
- Value
- 8260
Station 28 port
- Target
- 8270
- Default
- 8270
- Value
- 8270
Station 29 port
- Target
- 8280
- Default
- 8280
- Value
- 8280
Station 30 port
- Target
- 8290
- Default
- 8290
- Value
- 8290
Station 31 port
- Target
- 8300
- Default
- 8300
- Value
- 8300
Station 32 port
- Target
- 8310
- Default
- 8310
- Value
- 8310
Station 33 port
- Target
- 8320
- Default
- 8320
- Value
- 8320
Station 34 port
- Target
- 8330
- Default
- 8330
- Value
- 8330
Station 35 port
- Target
- 8340
- Default
- 8340
- Value
- 8340
Station 36 port
- Target
- 8350
- Default
- 8350
- Value
- 8350
Station 37 port
- Target
- 8360
- Default
- 8360
- Value
- 8360
Station 38 port
- Target
- 8370
- Default
- 8370
- Value
- 8370
Station 39 port
- Target
- 8380
- Default
- 8380
- Value
- 8380
Station 40 port
- Target
- 8390
- Default
- 8390
- Value
- 8390
Station 41 port
- Target
- 8400
- Default
- 8400
- Value
- 8400
Station 42 port
- Target
- 8410
- Default
- 8410
- Value
- 8410
Station 43 port
- Target
- 8420
- Default
- 8420
- Value
- 8420
Station 44 port
- Target
- 8430
- Default
- 8430
- Value
- 8430
Station 45 port
- Target
- 8440
- Default
- 8440
- Value
- 8440
Station 46 port
- Target
- 8450
- Default
- 8450
- Value
- 8450
Station 47 port
- Target
- 8460
- Default
- 8460
- Value
- 8460
Station 48 port
- Target
- 8470
- Default
- 8470
- Value
- 8470
Station 49 port
- Target
- 8480
- Default
- 8480
- Value
- 8480
Station 50 port
- Target
- 8490
- Default
- 8490
- Value
- 8490
ACME storage
- Target
- /var/app/acme
- Default
- /mnt/user/appdata/azuracast_relay/acme
- Value
- /mnt/user/appdata/azuracast_relay/acme
Temporary data storage
- Target
- /var/app/www_tmp
- Default
- /mnt/user/appdata/azuracast_relay/tmp
- Value
- /mnt/user/appdata/azuracast_relay/tmp
Stations data storage
- Target
- /var/app/stations
- Default
- /mnt/user/appdata/azuracast_relay/stations
- Value
- /mnt/user/appdata/azuracast_relay/stations
Compose project name
- Target
- COMPOSE_PROJECT_NAME
- Default
- azurarelay
- Value
- azurarelay
Internal HTTP port
- Target
- AZURARELAY_HTTP_PORT
- Default
- 80
- Value
- 80
Internal HTTPS port
- Target
- AZURARELAY_HTTPS_PORT
- Default
- 443
- Value
- 443