Skip to content

UniqueBibleApp webtop on Windows

Jump to bottom
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.

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"
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 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

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

You should see:

Screenshot 2022-02-22 161747

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.

1st_run

More about Webtop version

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

Clone this wiki locally