Skip to content

[Update] Azuracast Marketplace Documentation #7303

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions ci/vale/dictionary.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1042,6 +1042,7 @@ iaas
IaC
icanhazip
icann
Icecast
iceweasel
icinga
icingacli
Expand Down Expand Up @@ -1361,6 +1362,7 @@ linodes
linroot
linter
Liquibase
Liquidsoap
lish
liskov
listdir
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
55 changes: 29 additions & 26 deletions docs/marketplace-docs/guides/azuracast/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
title: "Deploy AzuraCast through the Linode Marketplace"
description: "AzuraCast is a self-hosted web radio station and management suite. Follow this guide to deploy AzuraCast on Linode using Marketplace Apps."
published: 2020-09-28
modified: 2022-03-08
modified: 2025-07-16
keywords: ['azuracast','marketplace', 'server']
tags: ["debian","ubuntu","marketplace", "web applications","linode platform", "cloud manager"]
image: DeployAzuraCast_OneClickApps.png
external_resources:
- '[About AzuraCast](https://www.azuracast.com/about/)'
- '[Troubleshooting AzuraCast](https://www.azuracast.com/help/)'
- '[AzuraCast Website](https://www.azuracast.com/)'
- '[Troubleshooting AzuraCast](https://www.azuracast.com/docs/help/troubleshooting/)'
- '[AzuraCast Github](https://github.com/azuracast/azuracast)'
aliases: ['/products/tools/marketplace/guides/azuracast/','/platform/marketplace/how-to-deploy-azuracast-with-marketplace-apps/', '/platform/one-click/how-to-deploy-azuracast-with-one-click-apps/','/guides/how-to-deploy-azuracast-with-one-click-apps/','/guides/how-to-deploy-azuracast-with-marketplace-apps/','/guides/deploy-azuracast-with-one-click-apps/','/platform/one-click/deploy-azuracast-with-one-click-apps/','/guides/azuracast-marketplace-app/']
authors: ["Akamai"]
Expand All @@ -18,7 +18,7 @@ marketplace_app_id: 662118
marketplace_app_name: "AzuraCast"
---

[AzuraCast](https://www.azuracast.com) is a free self-hosted web radio station and management suite. Installation is simple with Marketplace Apps, and the intuitive web interface makes running a web station easy. After installation, you can be broadcasting within in minutes.
[AzuraCast](https://www.azuracast.com) is a free self-hosted web radio station and management suite. The installation with Marketplace Apps is simple and the intuitive web interface makes the running a web station easy. After the installation, you can be broadcasting within minutes.

## Deploying a Marketplace App

Expand All @@ -27,53 +27,56 @@ marketplace_app_name: "AzuraCast"
{{% content "marketplace-verify-standard-shortguide" %}}

{{< note >}}
**Estimated deployment time:** AzuraCast should be fully installed within 2-5 minutes after the Compute Instance has finished provisioning.
**Estimated deployment time:** AzuraCast should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning.
{{< /note >}}

## Configuration Options

- **Supported distributions:** Debian 10, Ubuntu 20.04 LTS
- **Supported distributions:** Ubuntu 24.04 LTS
- **Recommended plan:** All plan types and sizes can be used.

## AzuraCast Options

- **Email address** *(required)*: Enter the email address to use for generating the SSL certificates.

{{% content "marketplace-required-limited-user-fields-shortguide" %}}

{{% content "marketplace-custom-domain-fields-shortguide" %}}

{{% content "marketplace-special-character-limitations-shortguide" %}}

## Getting Started After Deployment

### Accessing AzuraCast

AzuraCast is now installed and ready to use.
Once you install AzuraCast:

1. Open your web browser and navigate to `http://[ip-address]/`, replacing *[ip-address]* with your Compute Instance's IPv4 address. See the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for information on viewing your IP address.
1. Open your web browser and navigate to `http://[domain]/admin`, where *[domain]* is the custom domain you entered during deployment or your Compute Instance's rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). To learn more about viewing IP addresses and rDNS, see [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/).

1. The first thing you want to do is create a *Super Administrator* account that has system-wide permissions.
1. Log in with your *Super Administrator* credentials. This account has system-wide permissions and was set up during the installation when you entered your Administrator Email Address.

!["AzuraCast Setup Account"](azuracast-setup-account.png "AzuraCast Setup Account")
!["AzuraCast Login"](azuracast-login.png "AzuraCast Login")

1. Next, AzuraCast prompts you to create a new radio station. Fill out the required fields, then click the **Save Changes** button at the bottom of the screen to continue.
1. Fill out the required fields in the registration form and click **Create and Continue**.

!["AzuraCast Create Station"](azuracast-create-station.png "AzuraCast Create Station")

1. On the next page you can set other settings including using a custom URL if you have one set up. Learn more about using a custom URL with Linode DNS in our [DNS Manager](/docs/products/networking/dns-manager/) guide. When you are finished, click the **Save Changes** button at the bottom of the screen to continue.

1. Your station is now ready. On the following page, you are taken to the control panel, and you are ready to start broadcasting your station.

1. To manage the station you just created click the **Manage** button in the **Station Overview** section. This will open the Station Dashboard for the station you created during setup.
1. Configure station's settings including the use of a custom URL, if you have one set up. To learn more about using a custom URL with Linode DNS, see [DNS Manager](/docs/products/networking/dns-manager/). Click **Save Changes**.

!["AzuraCast Manage Station"](azuracast-manage-station.png "AzuraCast Manage Station")
Your station is now ready and you can start broadcasting. To manage the created station, click **Manage Stations** in the **Dashboard** section. This opens the *Station Dashboard* that you can use to control your station, add songs, add DJs, take requests, and more.

1. Here you can control your station, add songs, add DJs, take requests, and more.
!["AzuraCast Manage Station"](azuracast-manage-station.png "AzuraCast Manage Station")

## Software Included

The AzuraCast Marketplace App installs the following software on your Linode:

| **Software** | **Description** |
|:--------------|:------------|
| [**Lquidsoap**](https://www.liquidsoap.info/) | An AutoDJ that keeps the tunes streaming.|
| [**Icecast 2.4 (Icecast-KH on supported systems)**](https://icecast.org/) | A broadcasting front end. |
| [**SHOUTcast 2 DNAS**](http://wiki.shoutcast.com/wiki/SHOUTcast_DNAS_Server_2) | An alternate broadcasting front end. |
| [**NGINX**](https://www.nginx.com/) | A webserver a proxy. |
| [**MariaDB**](https://mariadb.org/) | A database. |
| [**PHP 7**](https://secure.php.net/) | General purpose programming language used for the website. |
| [**InfluxDB**](https://www.influxdata.com/) | A database for capturing time-series based statistics. |
| [**Redis**](https://redis.io/) | A database for session management and caching |
| [**AzuraCast**](https://www.azuracast.com/) | All-in-one web radio management suite (includes Liquidsoap, Icecast, NGINX, PHP, and all radio streaming components) |
| [**MariaDB**](https://mariadb.org/) | Open-source relational database for data storage |
| [**Redis**](https://redis.io/) | In-memory data structure store for caching and session management |
| [**Docker**](https://www.docker.com/) | Container runtime for application deployment |
| [**Docker Compose**](https://docs.docker.com/compose/) | Tool for defining and running multi-container Docker applications |

{{% content "marketplace-update-note-shortguide" %}}