From cd52d63c111d8aba1b56ffc88d0f480f83c42a1d Mon Sep 17 00:00:00 2001 From: Joseph Cardillo Date: Mon, 10 Mar 2025 12:59:36 -0400 Subject: [PATCH 1/2] update distro and instructions --- docs/marketplace-docs/guides/owncast/index.md | 50 ++++++++++++++++--- 1 file changed, 44 insertions(+), 6 deletions(-) diff --git a/docs/marketplace-docs/guides/owncast/index.md b/docs/marketplace-docs/guides/owncast/index.md index 5f8d8d9fd4c..13fe9ce2647 100644 --- a/docs/marketplace-docs/guides/owncast/index.md +++ b/docs/marketplace-docs/guides/owncast/index.md @@ -2,7 +2,7 @@ title: "Deploy Owncast through the Linode Marketplace" description: "This guide shows how to install Owncast, a self-hosted live video and webchat server that works with common broadcasting software, from the Linode One-Click Marketplace." published: 2021-03-31 -modified: 2022-03-08 +modified: 2025-03-10 keywords: ['live streaming','marketplace','web chat'] tags: ["marketplace", "linode platform", "cloud manager"] external_resources: @@ -30,23 +30,61 @@ marketplace_app_name: "Owncast" ## Configuration Options -- **Supported distributions:** Debian 10 -- **Recommended plan:** All plan types and sizes can be used with Owncast. +- **Supported distributions:** Ubuntu 24.04 LTS +- **Suggested plan:** All plan types and sizes can be used with Owncast. ### Owncast Options - **Hostname**: Your public hostname for your Owncast server. Required for SSL. - **Email**: Your email address for configuring SSL. +{{% content "marketplace-limited-user-fields-shortguide" %}} + +{{% content "marketplace-custom-domain-fields-shortguide" %}} + ## Getting Started after Deployment -### Access your Owncast App +### Obtain the Credentials + +Once the app is deployed, you need to obtain the credentials from the server. + +To obtain credentials: + +1. Log in to your new Compute Instance using one of the methods below: + + - **Lish Console**: Log in to Cloud Manager, click the **Linodes** link in the left menu, and select the Compute Instance you just deployed. Click **Launch LISH Console**. Log in as the `root` user. To learn more, see [Using the Lish Console](/docs/products/compute/compute-instances/guides/lish/). + - **SSH**: Log in to your Compute Instance over SSH using the `root` user. To learn how, see [Connecting to a Remote Server Over SSH](/docs/guides/connect-to-server-over-ssh/). + +1. Run the following command to access the credentials file: -After Owncast has finished installing, you can access your server with your Linode's IPv4 address. Copy your Linode’s IPv4 address from the [Linode Cloud Manager](https://cloud.linode.com), and then connect to the server from your browser using your Linode's IPv4 address and port `8080`(for example `192.0.2.0:8080`). + ```command + cat /home/$USERNAME/.credentials + ``` + +This returns passwords that were automatically generated when the instance was deployed. Save them. Once saved, you can safely delete the file. + +## Using Owncast + +After Owncast has finished installing, you can access your server with your Linode's custom domain or Reverse DNS. ![owncast.png 'The Owncast stream view'](owncast.png) -With Owncast running, you can begin to configure your new server. Visit the Admin settings, located at `/admin` (for example `192.0.2.0:8080/admin`). Visit the [Configuration Instructions](https://owncast.online/docs/configuration/?source=linodemarketplace) to learn how you can change your video settings, web page content, and more. +With Owncast running, you can begin to configure your new server. Visit the Admin settings, located at `/admin` (for example `example.com/admin`) and use the credentials (for the `admin` user) you obtained in the previous section to log in. Visit the [Owncast Documentation](https://owncast.online/docs/) to learn how you can change your video settings, web page content, and more. + +### Connecting Your Streaming Software + +To start streaming with Owncast: + +1. Log in to the Owncast admin panel at `/admin` +2. Navigate to the **Stream Keys** section +3. Copy your streaming key +4. Open your broadcasting software (like OBS Studio) +5. Configure your streaming settings: + - Service: Custom + - Server: `rtmp://your-domain-or-ip/live` + - Stream Key: The key you copied from the admin panel + +For more detailed instructions on configuring specific streaming software, refer to the [Owncast Documentation](https://owncast.online/docs/broadcasting/). On the server, Owncast is installed in the `/opt/owncast` directory. You'll find all your data files there. This is also where you can upgrade your Owncast server in the future. From 199cb513ed4046a1139a0c7107ed8a5343af7bef Mon Sep 17 00:00:00 2001 From: Magda Sulik Date: Wed, 12 Mar 2025 11:45:32 +0100 Subject: [PATCH 2/2] editorial review --- docs/marketplace-docs/guides/owncast/index.md | 23 +++++++++---------- 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/docs/marketplace-docs/guides/owncast/index.md b/docs/marketplace-docs/guides/owncast/index.md index 13fe9ce2647..c01a793c8c5 100644 --- a/docs/marketplace-docs/guides/owncast/index.md +++ b/docs/marketplace-docs/guides/owncast/index.md @@ -8,6 +8,7 @@ tags: ["marketplace", "linode platform", "cloud manager"] external_resources: - '[Owncast](https://owncast.online/)' - '[Owncast Github](https://github.com/owncast/owncast)' +- '[Owncast Documentation](https://owncast.online/docs/)' aliases: ['/products/tools/marketplace/guides/owncast/','/guides/deploy-owncast-with-marketplace-apps/','/guides/owncast-marketplace-app/'] authors: ["Akamai"] contributors: ["Akamai"] @@ -44,8 +45,6 @@ marketplace_app_name: "Owncast" ## Getting Started after Deployment -### Obtain the Credentials - Once the app is deployed, you need to obtain the credentials from the server. To obtain credentials: @@ -67,25 +66,25 @@ This returns passwords that were automatically generated when the instance was d After Owncast has finished installing, you can access your server with your Linode's custom domain or Reverse DNS. -![owncast.png 'The Owncast stream view'](owncast.png) +With Owncast running, you can begin to configure your new server. Visit the Admin settings, located at `/admin` (for example `example.com/admin`) and use the credentials (for the `admin` user) you obtained in the previous section to log in. -With Owncast running, you can begin to configure your new server. Visit the Admin settings, located at `/admin` (for example `example.com/admin`) and use the credentials (for the `admin` user) you obtained in the previous section to log in. Visit the [Owncast Documentation](https://owncast.online/docs/) to learn how you can change your video settings, web page content, and more. +![owncast.png 'The Owncast stream view'](owncast.png) ### Connecting Your Streaming Software To start streaming with Owncast: -1. Log in to the Owncast admin panel at `/admin` -2. Navigate to the **Stream Keys** section -3. Copy your streaming key -4. Open your broadcasting software (like OBS Studio) -5. Configure your streaming settings: - - Service: Custom - - Server: `rtmp://your-domain-or-ip/live` - - Stream Key: The key you copied from the admin panel +1. Log in to the Owncast admin panel at `/admin`. +1. Go to the **Stream Keys** section and copy your streaming key. +1. Open your broadcasting software, for example OBS Studio. +1. Configure your streaming settings with following values: + - **Service**: **Custom**, + - **Server**: `rtmp://your-domain-or-ip/live`, + - **Stream Key**: The key you copied from the admin panel. For more detailed instructions on configuring specific streaming software, refer to the [Owncast Documentation](https://owncast.online/docs/broadcasting/). On the server, Owncast is installed in the `/opt/owncast` directory. You'll find all your data files there. This is also where you can upgrade your Owncast server in the future. + {{% content "marketplace-update-note-shortguide" %}}