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