Skip to content

UniqueBibleApp webtop on Windows

Eliran Wong edited this page Feb 22, 2022 · 7 revisions

UniqueBibleApp webtop on Windows

This page described how to setup webtop version on Windows.

UniqueBibleApp webtop version is easy to set up if docker is in place.

On Windows, to docker setup may take a few more steps than on macOS or Linux, as users need to set up WSL before they can install docker.

If you prefer not to setup WSL or docker, you can simply setup python library on Windows to run Unique Bible App. We wrote notes about it on another page: https://github.com/eliranwong/UniqueBible/wiki/Install-on-Windows

However, if you appreciate some extra features only available on webtop version, you may follow instructions below to install the webtop version.

An Overview

WSL version 2 is required for running docker.

Docker is required for running Unique Bible App webtop version.

Therefore, to run Unique Bible App webtop version, users need to set up BOTH WSL version 2 AND docker first.

Set up WSL version 2

  1. Search on Windows "Turn Windows Features On or Off"
turn_windows_features_on
  1. Select "Windows Subsystem for Linux" and "Virtual Machine Platform"
TurnWindowsFeaturesOnOrOff
  1. Install driver for vGPU. Choose either one of three options available on https://docs.microsoft.com/en-us/windows/wsl/tutorials/gui-apps#prerequisites:
  • Intel GPU driver for WSL
  • GPU driver for WSL
  • NVIDIA GPU driver for WSL
  1. Right-click Windows icon and run PowerShell as an Administrator:

wsl --install -d Ubuntu

wsl --update

wsl --shutdown

Set up Unique Bible App webtop version

  1. Open Windows PowerSheell (for general users; not for administrator) and run:

wsl

sudo docker run -d --name=uniquebibleapp --security-opt seccomp=unconfined -e PUID=1000 -e PGID=1000 -e TZ=Europe/London -e SUBFOLDER=/ -e KEYBOARD=en-gb-qwerty -p 3000:3000 -v ~/uniquebibleapp-webtop:/config -v /var/run/docker.sock:/var/run/docker.sock --shm-size="1gb" --restart unless-stopped eliranwong/uniquebibleapp

Screenshot 2022-02-22 161747 1st_run

Set up docker

  1. Download "Docker Desktop for Windows" and run the installer.

  2. Open "Docker Desktop for Windows" at least once and agree to the terms.

  3. Restart Windows

To run Unique Bible App webtop version

Open "localhost:3000" on a web browser.

More about Webtop version

https://github.com/eliranwong/uniquebibleapp-webtop

Clone this wiki locally