Viur3 on Windows

Warning

This way of installation will work, but the documentation is deprecated.

Although Viur3 is made to run on Linux and Apple OS, there is a workaround for it to function on Windows operating systems.

We can only assure the following steps to work on devices using the Windows 10 operating system and Ubuntu as a subsystem.

Installing Linux Subsystem 2 (WSL2) for Windows 10

Step 1: Prepare your Device for WSL2

Some devices are per default prepared for the usage of WSL2.

If your system is not prepared for the usage of WSL2 you can follow this manual:

https://docs.microsoft.com/de-de/windows/wsl/install-win10#manual-installation-steps

Step 2: Install the Ubuntu sub system for Windows

If you do not own a Linux distribution for your Windows device you can download Ubuntu in the Microsoft Store.

https://www.microsoft.com/en-us/p/ubuntu/9nblggh4msv6?activetab=pivot:overviewtab

By starting the Program after your installation you prepare your device for the usage of Ubuntu. After typing in your username and password you can use the console fully.

Step 3 (Optional): Install the Windows Terminal

To avoid problems with the Ubuntu console and for usability and accessibility reasons you can additionally download the Windows Terminal.

https://www.microsoft.com/de-de/p/windows-terminal/9n0dx20hk701?activetab=pivot

You can use your Ubuntu console using the bash command

Installing Prerequisites for Viur3

Viur3 is a framework for the Google App Engine. Therefore, you need install the Google Cloud SDK and some features of it.

Step 1: Install the Google SDK

To install the basics of the Google Cloud SDK you need to follow this tutorial:

https://cloud.google.com/sdk/docs/install

After installing the Google Cloud SDK you need to install the following additional Components:

1. google-cloud-sdk-app-engine-python: sudo apt-get isntall google-cloud-sdk-app-engine-python

2. google-cloud-sdk-app-engine-python-extras: sudo apt-get isntall google-cloud-sdk-app-engine-python-extras

3. google-cloud-sdk-datastore-emulator: sudo apt-get isntall google-cloud-sdk-datastore-emulator

4. google-cloud-sdk-cloud-build-local: sudo apt-get isntall google-cloud-sdk-cloud-build-local

Step 2: Check for Python2 and Python3

Check if your system recognizes your python installation. GAE will need python2 and python3 to work.

You can check your status with these commands: 1. python2 --version 2. python3 --version

If one of the Versions is not installed you can manually reinstall them by using the following commands: sudo apt-get install python2 sudo apt-get install python3

Step 3: install python-is-python3

For Ubuntu 20 the default Python command is undefined. Therefore, most packages will depend explicitly on the python2 or python3 command.

By using python-is-python3 we can globally avoid errors thrown by the unnumbered python command.

To install python-is-python3 use the following command: sudo apt-get install python-is-python3

You can read more about python-is-python3 here: https://packages.ubuntu.com/focal/python-is-python3

Step 4: Install the Python3 Virtual Environment

For Viur3 to run you will need a Python Virtual Environment.

To install the Virtual Environment use the following command: sudo apt-get install python-venv