Windows self-hosted solution installation guide

To purchase a license for a self-hosted software, please contact the Customer Support Centre ([email protected]).

Windows OS requirements

Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.

Windows 10 64-bit: Home or Pro 21H1 (build 19043) or higher, or Enterprise or Education 20H2 (build 19042) or higher.

Hardware requirements

The following hardware prerequisites are required to successfully run WSL 2 on Windows 10 or Windows 11:

64-bit processor with Second Level Address Translation (SLAT)

4GB system RAM

BIOS-level hardware virtualization support must be enabled in the BIOS settings.

What is WSL

Installing WSL

For simplicity, we generally recommend using the wsl --install to install Windows Subsystem for Linux, but if you're running an older build of Windows, that may not be supported. We have included the manual installation steps below. If you run into an issue during the install process, check the installation section of the troubleshooting guide

Enable the Windows Subsystem for Linux

You must first enable the “Windows Subsystem for Linux” optional feature before installing any Linux distributions on Windows.

Open PowerShell as Administrator (Start menu > PowerShell > right-click > Run as Administrator) and enter this command:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

We recommend updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 — Install your Linux distribution of choice. To update to WSL 2, wait to restart your machine and move on to the next step.

Before installing WSL 2, you must enable the Virtual Machine Platform optional feature. Your machine will require virtualization capabilities to use this feature.

Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Restart your machine to complete the WSL install and update to WSL 2.

Download the Linux kernel update package

From the Windows manual page or from Direct link.

  1. Run the update package downloaded in the previous step. 
    (Double-click to run — you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)
  2. Once the installation is complete, move on to the next step — setting WSL 2 as your default version when installing new Linux distributions. (Skip this step if you want your new Linux installs to be set to WSL 1).

Set WSL 2 as your default version

Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Install docker desktop

Download Docker Desktop here. 

Double-click Docker Desktop Installer.exe to run the installer.

When prompted, ensure the Use WSL 2 instead of Hyper-V option on the Configuration page is selected or not depending on your choice of backend.

If your system only supports one of the two options, you will not be able to select which backend to use.

Follow the instructions of the installation wizard to authorize the installer and proceed with the install.

When the installation is successful, click Close to complete the installation process.

If your admin account is different to your user account, you must add the user to the docker-users group. 

Run Computer Management as an administrator and navigate to Local Users and Groups > Groups > docker-users. 

Right-click to add the user to the group. 
Log out and log back in for the changes to take effect.
Restart computer.

Launching Callaba

Start Docker Desktop, accept the agreement, wait for the daemon to start (the field in the bottom left corner will turn green) and skip the tutorial (Skip tutorial).

Run command line (right click on start)

Log in to the registry, using the credits provided by the Callaba Support.

docker login registry.callabacloud.com

USERNAME
PASSWORD

Next, take the docker-compose.callaba-cloud.yml file (you’ll get it from the support too) and execute the following command :

docker-compose -f <File_LOCATION>\docker-compose.callaba-cloud.yml up -d

Wait for the images to download and run. When finished, open 127.0.0.1:80 in the browser and login.

Username : admin
Password : password

Go to settings and change the administrator password.

Troubleshooting

If cc-api fails to start with error TCP: 0.0.0.0:80 Unavailabe. Permisson denied, you need to disable the built-in services occupying port 80. To do this, run the NET stop HTTP command on the command line.

If you have any questions, please contact us at: [email protected]
We will respond to you within 48 hours.
Happy streaming!