Skip to content
Merged
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
43 changes: 31 additions & 12 deletions docs/marketplace-docs/guides/liveswitch/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Deploy LiveSwitch through the Linode Marketplace"
description: "Learn how to deploy LiveSwitch Server, an enterprise video streaming service, through the Linode Marketplace."
published: 2022-05-31
modified: 2023-04-18
modified: 2025-05-19
keywords: ['liveswitch','streaming','video']
tags: ["marketplace", "linode platform", "cloud manager"]
external_resources:
Expand All @@ -15,14 +15,12 @@ marketplace_app_id: 1008123
marketplace_app_name: "LiveSwitch"
---

[LiveSwitch Server](https://www.liveswitch.io/products/liveswitch-server) is a self-hosted WebRTC live video streaming platform. It provides high quality and reliable streaming for both audio and video media. Here's more from the publisher:
[LiveSwitch Server](https://www.liveswitch.io/products/liveswitch-server) is a self-hosted WebRTC live video streaming platform for building low-latency video, audio, and data streaming apps using WebRTC with support for P2P, SFU, MCU, recording, and SIP integration.

> LiveSwitch is the most flexible video and audio WebRTC SDK on the market. Ultra-low latency meets advanced features for engaging with your audience. LiveSwitch offers a complete solution (front-end and back-end) to develop commercial WebRTC applications.

This Marketplace App deploys a back-end demonstration server, running signalling, media, and TURN together on a single server. It is designed to be tested alongside the official client SDKs for .NET, .NET Core, iOS, Android, Xamarin, Maui, Unity and more. To download these SDKs, see the [Client SDK](https://developer.liveswitch.io/liveswitch-server/guides/intro.html) page on the LiveSwitch Developer documentation site.
This Marketplace App deploys a back-end demonstration server, with signalling, media, and TURN services all provided by a single `liveswitch-gateway` container running on one server. It's designed to be tested alongside the official client SDKs for .NET, .NET Core, iOS, Android, Xamarin, Maui, Unity, and more. To download these SDKs, see the [Client SDK](https://developer.liveswitch.io/liveswitch-server/guides/intro.html) documentation.

{{< note >}}
Using LiveSwitch Server may require a paid license. To obtain a license, [contact LiveSwitch](https://www.liveswitch.io/meetings/jake-steele/linode). Licenses are not available directly through Linode.
Using LiveSwitch Server may require a paid license. To obtain a license, [contact LiveSwitch](https://support.liveswitch.io/kb-tickets/new). Licenses are not available directly through Akamai.
{{< /note >}}

## Deploying a Marketplace App
Expand All @@ -37,21 +35,42 @@ Using LiveSwitch Server may require a paid license. To obtain a license, [contac

## Configuration Options

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

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

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

## Getting Started after Deployment

After deployment, follow the instructions below to access your application.

### Accessing the LiveSwitch App

1. Open your web browser and navigate to `http://[ip-address]:9090/admin`, replacing *[ip-address]* with your Compute Instance's IP address or rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). See the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for information on viewing IP addresses and rDNS.
1. In a web browser, go to `https://[ip-address]/admin`, replacing *[ip-address]* with your Compute Instance's IP address or rDNS domain (such as `192-0-2-1.ip.linodeusercontent.com`). See the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for information on viewing IP addresses and rDNS.

1. Follow the *Welcome* setup wizard to input your license key and create your user.

After completing the setup, you should see the main Configuration Console for your installation. To learn more about how to manage your instance, see the [Configuration Console documentation](https://developer.liveswitch.io/liveswitch-server/server/configuration/configuration-console.html).

Now that you've accessed your LiveSwitch instance, check out [the official LiveSwitch quick start documentation](https://developer.liveswitch.io/liveswitch-server/get-started/js-server/quickstart-js.html) to learn how to further use your LiveSwitch instance.

## Software Included

1. The *Welcome* setup wizard is displayed. Follow the prompts in this wizard to input your license key and create your user.
| **Software** | **Description** |
|:--------------|:------------|
| **LiveSwitch Gateway** | Main LiveSwitch service for WebRTC communication (signalling, media, TURN) |
| **Docker** | Platform for running the LiveSwitch containers |
| **Docker Compose** | Tool for defining and running multi-container Docker applications |
| **Redis** | In-memory data structure store for signaling and messaging |
| **PostgreSQL** | Database for LiveSwitch configuration and data |
| **RabbitMQ** | Message broker for recording workflows |
| **Nginx** | Web server used as reverse proxy |
| **Fail2ban** | Provides protection against brute force and authentication attempts |
| **UFW** | Firewall utility |
| **Certbot** | Used to obtain HTTPS/TLS/SSL certificates for the provided domain |

1. After completing the setup wizard, you should see the main Configuration Console for your installation. To learn more about how to manage your instance, see the [Configuration Console documentation](https://developer.liveswitch.io/liveswitch-server/server/configuration/configuration-console.html).

Now that you’ve accessed your LiveSwitch instance, check out [the official LiveSwitch quick start documentation](https://developer.liveswitch.io/liveswitch-server/get-started/js-server/quickstart-js.html) to learn how to further use your LiveSwitch instance.

{{% content "marketplace-update-note-shortguide" %}}
Binary file not shown.
Binary file not shown.
Binary file not shown.