Skip to main content

Remote development

If your local machine does not meet all requirements for development with the VIKTOR platform you can choose to use a remote development environment. A remote development environment is a development environment that is hosted in the cloud and can often be used together with an IDE in the browser. Examples of remote development environments are Replit, Github Codespaces and Gitpod.

Setup instructions

With Gitpod you can connect both public and private repositories, and it has a free tier that includes 50 hours of development time per month. We therefore recommend to use Gitpod if development on your local machine is not possible.


Follow the steps below to set up a Gitpod workspace and get started with developing on the VIKTOR platform:

  1. Create a repository on GitHub, GitLab or Bitbucket for your VIKTOR app (if you don't have one already).

  2. Add a Gitpod configuration file called .gitpod.yml to your project's root directory with the content shown below. Do not forget to commit the changes. This configuration file instructs Gitpod to download the VIKTOR CLI upon initialization of the workspace. More information on the Gitpod configuration file can be found here.

    - name: VIKTOR
    init: |
    curl -Lo viktor-cli ''
    chmod +x viktor-cli
    mv viktor-cli /workspace/viktor-cli
    command: |
    echo "export PATH=\$PATH:/workspace" >> ~/.bashrc
    source ~/.bashrc
  3. Log in to Gitpod with your GitLab, GitHub or Bitbucket account.

  4. Click on Settings > Variables to configure several environment variables required to authenticate with the VIKTOR platform. Click the New Variable button to add a new environment variable. The following variables should be added:

    • Insert a variable with name VIKTOR_ENV with the following value:
      • Free users:
      • Paid users: {company} (substitute {company} with the name of your company)
    • Insert a variable with the name VIKTOR_DEV with the email address that your VIKTOR account is registered on.
    • Insert a variable with the name VIKTOR_TOKEN with your personal token. You can generate a token by logging in to your development environment. If you are logging in for the first time, use the link from the activation mail to generate a password to log in to the development environment. Alternatively, you can click "Forgot Password" to receive a mail to (re)set your password. After logging in close the first-time user modal (this modal is shown when you have not activated your account yet) and go to the settings page by clicking the three dots next to your name in the top-right corner and after that clicking 'Settings'. Select the 'Developer Account' tab and click the 'Generate new token' button. Your account will get activated automatically when you follow the instructions below.


    You can scope these variables to only be available for the repository you created in step 1 by inserting the owner of the repository (i.e. your GitLab, GitHub or Bitbucket username) and the name of the repository separated by a /.

  5. Click the button 'New Workspace' to initialize your Gitpod workspace. You will be asked to select a repository. Select the repository created in step 1 from the list. You will now land in a browser-based version of Visual Studio Code, a popular Python IDE.

  6. Run the following command to verify the installation:

    viktor-cli check-system

    This should print: V Your system is ready to use VIKTOR with isolation mode 'venv'.

  7. Congratulations, you are now ready to start coding your first VIKTOR app! 🚀

If you are already familiar with building apps in VIKTOR you can type viktor-cli create-app in the Gitpod terminal to create an empty app and start developing from here.

Running the demo app

If you are new to VIKTOR, the easiest way to get your first app up and running is by running the demo app. Generate the demo app in the current folder by typing the following command in the Gitpod terminal:

viktor-cli create-app --demo .

Install the app with:

viktor-cli install

Installation can take up to 5 minutes and is finished when the command-line shows the message: "The application has successfully been installed".

Subsequently, start the app with:

viktor-cli start

The CLI will establish a connection with VIKTOR and notify when ready by showing the message "App is ready". Open the app in your browser by visiting the URL shown in the command-line shell, and log in with your username and password:

If everything went well, the demo app has been installed and is running in your browser. You can now continue the 'Getting started' section here.