UniqueBibleApp webtop on Windows - eliranwong/UniqueBible GitHub Wiki

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.

Windows version required

  • Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.
  • Windows 10 64-bit: Home or Pro 2004 (build 19041) or higher, or Enterprise or Education 1909 (build 18363) or higher.

Set up WSL version 2

  1. Search on Windows "Turn Windows Features On or Off"
  1. Select "Windows Subsystem for Linux" and "Virtual Machine Platform"
  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 according to your computer GPU:
  • 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 docker

  1. Download "Docker Desktop for Windows" from https://docs.docker.com/desktop/windows/install/ and run the installer.

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

  3. Restart Windows

Set up Unique Bible App webtop version

  1. Open Windows PowerShell (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

or can try without sudo command:

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

You should see:

To run Unique Bible App webtop version

Open localhost:3000 on a web browser. The first run normally takes few minutes for set up. Once setup is finished, you should see.

More about Webtop version

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