DocumentationChangelogUsage guide
Log In
Documentation

Prepare host OS

To start using Live Transcoder, there are few more steps to do, such as login to the Comprimato DockerHub and downloading the docker-compose file. Once you are finished with those, you can start Live Transcoder and save the image of your VM instance for future use.

SSH to the host OS

The easiest way to SSH to the host OS is to use a designated SSH web console by Google Cloud.

You can find it by navigating from the Google Cloud dashboard to Compute Engine and then to VM instances.

❗️

Google Startup Script delay!

Upon first SSH access to your instance, please run the following command before proceeding further:

sudo journalctl -u google-startup-scripts.service -f

This is due to a delay when SSH access is available to the instance but the startup script has not run/finished and installed all pre-requisites. Please ensure startup script has completed with the following line before proceeding to docker deployment:

zz-deployment-test123 systemd[1]: Finished Google Compute Engine Startup Scripts.

Use docker command without sudo

Allow running all docker commands as a non-root user by:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

Enable coredumps

Enabling coredumps on your host instance helps us perform full diagnostics when an issue occurs.

Using NDI Discovery server

If you plan to utilize NDI Discovery server, you must disable or remove mDNS feature from your host instance first.

High bitrate streaming

To be able to stream high bitrate codecs flawlessly, you need to adjust UDP kernel buffer size of your host instance first.

👍

All Done!

Your instance is fully prepared to run Live Transcoder in docker.

📘

Save the VM image for future

If you plan to spawn more instances or you'd like to avoid setting instances up again for any other reason, you can save the VM instance's image with Live Transcoder as a part of it.

If you'd like to save the environment with Live Transcoder, first, continue to Run Live Transcoder in docker section and then return here and proceed with the guide below.

Save the machine image

From the Google Cloud dashboard, navigate to Compute Engine and then to VM instances.

Select the three-dots menu on the left side of the VM instance and click on Create new machine image.

On the configuration page:

  • Specify Name of your machine image
  • Select whether the image should be bound to a particular Location

And finally, hit the Create button.

Creating an instance using a machine image

From the Google Cloud dashboard, navigate to Compute Engine and then to VM instances.

Click on Create instance button located at the top of the page.

Select the New VM instance from machine image option from the left panel.

Select the desired image and click on Continue.

On the configuration page, you should:

  • Specify a Name for your new instance
  • Check the selected Region
  • And make sure the instance type is switched to GPUs in Machine configuration section

All other parameters match those you used in the past when creating the VM the image is based on.

Proceed by hitting the Create button.


What’s Next

With the instance up and running, you are good to proceed to the next step - Running a docker container with Live Transcoder in it.