diff --git a/docs/marketplace-docs/guides/owncast/index.md b/docs/marketplace-docs/guides/owncast/index.md index 5f8d8d9fd4c..c01a793c8c5 100644 --- a/docs/marketplace-docs/guides/owncast/index.md +++ b/docs/marketplace-docs/guides/owncast/index.md @@ -2,12 +2,13 @@ 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: - '[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"] @@ -30,24 +31,60 @@ 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 +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: + + ```command + cat /home/$USERNAME/.credentials + ``` -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`). +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. + +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. ![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. +### Connecting Your Streaming Software + +To start streaming with Owncast: + +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" %}}