Install Using Docker

Docker is a tool that uses containers to make it easier to create, deploy, and run applications. LiveSwitch provides Gateway and Media Server Docker images with all their required dependencies, so you can install and run LiveSwitch services in Docker containers. Using Docker containers makes rolling out a cluster environment much more convenient.

Note

LiveSwitch’s Docker installation supports Linux only.

To install LiveSwitch using Docker, do the following:

  1. Follow the instructions in the Gateway Servers Docker Quick Start Guide.
  2. Follow the instructions in the Media Servers Docker Quick Start Guide.
  3. If you want to install Recording Monitor, follow the instructions in the Recording Monitor Docker Quick Start Guide.
  4. If you want to install Recording Mover, follow the instructions in the Recording Mover Docker Quick Start Guide.
  5. If you want to install Recording Muxer, follow the instructions in the Recording Muxer Docker Quick Start Guide.
  6. If you want SIP, follow the instructions in the SIP Connector Docker Quick Start Guide.
  7. To make sure the installation is successful, visit the LiveSwitch Console at http://localhost:9090/admin.

To update LiveSwitch using Docker, do the following:

  1. Stop the containers docker stop my_container.
  2. Remove the containers docker rm my_container.
  3. Run the desired version of the container as per the applicable instructions above.
Note

You do not need to stop or remove the Postgres or Redis containers unless you are looking to do a completely fresh install. Removing Postgres will delete your current LiveSwitch configuration.

Warning

All Gateways must be updated before any of the other services. This is for two reasons:

  1. PostgreSQL migrations are only done when a Gateway starts. If you update a different server first, the migrations won’t have been applied and the server will fail to start.
  2. We guarantee and test older services connecting to newer Gateways. We don’t test or guarantee the other way (newer servers connecting to old Gateways).