Skip to main content

Install VIKTOR with Docker

caution

The installation procedure to run VIKTOR using Docker is not recommended for first-time users.

By using Docker, running the code in development will more closely resemble production, so the chance of encountering differences between development and production is smaller. We recommend Docker only for experienced developers, as setting up Docker for Windows is not always convenient and, depending on your company size, may require a paid subscription.

Prerequisites​

Enterprise IT

If you want to use VIKTOR within an enterprise IT-environment, please contact your IT-department to verify that your machine meets all requirements. Alternatively, you can consider using a cloud-based development environment.

Before you start the installation procedure, you can go through the following checklist to make sure your setup is ready for installation:

  • Machine should run on Windows 10 Home/Pro/Enterprise or Linux.

  • Python (64-bit); the programming language used by VIKTOR.

  • You will need personal VIKTOR credentials (try for free!).

  • Virtualization needs to be turned on on your machine.
    Go to Task manager → Performance and see if "Virtualization" is enabled.

    docker-bios-virtualization

caution

If enabling of "Virtualization" is not allowed, it must be enabled in the BIOS of the machine first. In the BIOS, enable “Virtualization Technology (VTx)” (location and name may vary per machine) to do so. Please contact your IT department if you don't have the necessary permissions to make adjustments in your BIOS.

What will I install?​

In order to use the VIKTOR platform, you need to install the following tools:

  • Docker: software used by the CLI to run your app code in an isolated 'container' in the background.
  • VIKTOR: the standard local installation, including VIKTOR's command-line interface (CLI), which you then switch to Docker.

Installing Docker​

Linux

If you are using Linux, Docker can be installed using the package manager.

There are two ways to install / use Docker on Windows:

The benefits and drawbacks of running on WSL2 are listed below:

+ installation and starting an app is fast
+ installation of an app does not fail when deep dependency trees are present
+ WSL2 is available for Windows Home, whereas Hyper-V is not
- WSL2 is not supported on all Windows versions
- conceptually more complex due to the separate Linux filesystem and command-line interface
- setting up requires more time

We recommend to choose the default Hyper-V method and only choose WSL2 if you use Windows Home or you are experiencing issues during app development.

Estimated time: 1 hour

  1. Install Docker on your machine. When prompted, ensure "Enable Hyper-V Windows Features" is selected or "Install required Windows components for WSL 2" is deselected (options differ per installation version).

  2. Open the Docker settings and disable the checkbox to use the WSL2 based engine in the "General" section, if this isn't the case yet:

    docker-hyper-v-backend

  3. Make sure that you share your user folder (C:\Users\<username>). Allowing sharing of drives or folders (shared drives) is necessary when using Linux containers. If this was not done during the installation, you can set it in Docker → Settings → Resources → File Sharing.

  4. In the start menu, type “Turn Windows features on or off” (“Turn windows features on or off”) and make sure that Hyper-V is checked:

    docker-windows-features-hyper-v

  5. You can check all required Hyper-V features by running the systeminfo command in cmd.exe. All requirements should have a value "yes". If this is not the case, please visit the website of Microsoft for more information.

Installing VIKTOR​

Install VIKTOR using the standard installation flow for local development:

  1. Go to your Personal settings
  2. In the menu go to Local development
  3. Here you click on Install VIKTOR.
  4. Complete all steps in the pop-up.

The pop-up detects your operating system. If you use WSL2, click I have a different operating system and select Linux, and run the installation steps in your Ubuntu shell.

See Standard installation for more details on this flow.

Switching to Docker​

The standard installation sets up VIKTOR's command-line interface (CLI) with the default isolation mode. To run your apps in Docker instead, open your command-line shell and run:

viktor-cli configure

The configure command goes through your current settings one by one. Press Enter to keep each setting as it is, and change only the isolation mode to docker.

System check​

Run the following command to verify the installation:

viktor-cli check-system --docker

The check system command performs several checks. The conclusion of the checks are printed at the end of the message:

Starting VIKTOR system check...

V Operating system internet access
V Docker runs
V Docker using correct container
V Docker access to user directory
V Docker internet access
V Docker access to PyPI
V Docker access to VIKTOR domains

The system check has been completed with the following conclusions:

V Your system is ready to use VIKTOR with isolation mode 'docker'

If all checks succeeded, a "V" will be printed in front of Your system is ready to use VIKTOR with isolation mode 'docker'.

If any of the system checks fails, additional information can be printed to the command-line by using the --verbose flag as follows:

viktor-cli check-system --docker --verbose