Updating Documentation for Installing and Running Vorta on Windows 10 WSL

[end-usr2]

I have Vorta running on Ubuntu in Windows 10 WSL and the backups are working. I installed Ubuntu without using power shell. The instructions that I found to do this did not work for me and it took much searching and trial and error to get it working. Is there somewhere I can send or post the steps that worked for me so that they can be available for others?

These instructions didn’t work for me…
https://vorta.borgbase.com/install/windows/
borgbase/vorta#297
https://eeems.website/running-vorta-on-windows/

[m3nu]

Updating the docs for WSL would be great. You can just add them to this issue and I'll add them to the docs.

Or, open a PR against Vorta's docs here: https://github.com/borgbase/vorta.borgbase.com (runs on Jekyll)

[end-usr2]

I’m a bit confused about the PR/Jekyll option, so I’ll post it here. Thanks!

Enable Windows Subsystem for Linux
	Click the Start button.
	Click Control Panel.
	Click Programs.
	Click Turn Windows features on or off.
	If you're prompted for an administrator password or confirmation, type the password or provide confirmation.
	Click the box next to "Windows Subsystem for Linux" to put a checkmark
	Click OK
	reboot

Install Ubuntu from Microsoft App Store
	Click the Start button
	Type Microsoft
	Click Microsoft Store 
	Search for Ubuntu

	Or install from here...
	https://www.microsoft.com/en-us/p/ubuntu/9nblggh4msv6

	Click Get
	Once it is done downloading, click Open
	Enter a default user name and password when prompted
	ref: https://ubuntu.com/tutorials/ubuntu-on-windows#4-install-ubuntu-for-windows-10

Upgrade Ubuntu version

	The vorta package is included starting with Ubuntu 21.04.
	ref: https://packages.ubuntu.com/search?keywords=vorta 

If it is before April 21, 2022 and Ubuntu 22.04 is not yet available, you will need to upgrade to a non-Long Term Support (non-LTS) version of Ubuntu.  
	ref: https://wiki.ubuntu.com/Releases

	To do so, you will need to...

	change Prompt=LTS to Prompt=normal in /etc/update-manager/release-upgrades using vi or another file editing option.

	To avoid usmerge error during upgrade, check that both of these don't exist
		/lib/udev/hwdb.bin and /usr/lib/udev/hwdb.bin exist

		If both exist, delete the oldest one.

	Start the upgrade	
	sudo do-release-upgrade

	If you get error and upgrade aborts,
	"lspci: Cannot find any working access method."

		Remove snapd package
		sudo apt purge snapd

		then try upgrade again...
		sudo do-release-upgrade

	ref: https://superuser.com/questions/1662669/upgrade-wsl-to-ubuntu-hirsute-21-04-from-20-10


	reboot Ubuntu
		Start > Services. Run as administrator
		Restart LXSSMANAGER service

Install vorta

	sudo apt install vorta


Run vorta
	vorta

	if you get error, "ImportError: libQt5Core.so.5 :  cannot open shared object file: No such file or directory"

		sudo strip --remove-section=.note.ABI-tag /usr/lib/x86_64-linux-gnu/libQt5Core.so.5

		refs: https://superuser.com/questions/1347723/arch-on-wsl-libqt5core-so-5-not-found-despite-being-installed
	https://askubuntu.com/questions/1034313/ubuntu-18-4-libqt5core-so-5-cannot-open-shared-object-file-no-such-file-or-dir

		then Run vorta
			vorta

	if you get error, "could not connect to display"...
		
		if you haven't already, 
		download and install VcXsrv in Windows...
		https://sourceforge.net/projects/vcxsrv/

		Run XLaunch
		Start > XLaunch

		select 'multiple windows' and set Display number to 0, click Next
		select 'start no client', click Next
		add a check for 'Disable access control', click Next
		click 'Finish' and hover over the XLaunch icon in the system tray and verify that is shows "0.0".

		find your IP address
			Start > Settings > Network and Internet > Wi-Fi or LAN (depending on your connection type) > Hardware properties
			note the IPv4 address

		back at the Ubuntu command line...
		export DISPLAY=192.168.1.1:0.0  (substitute your IP address from above)
		export LIBGL_ALWAYS_INDIRECT=1

		Run vorta
			vorta
		 
	ref: https://github.com/microsoft/WSL/issues/4793

Configure Vorta and BorgBase...
	
	ref: https://www.youtube.com/watch?v=asZX2YbTaNE

If you need to mount a drive or share...

  To see currently mounted drives
     mount
	
	Mount removable media: (e.g. D:)

		sudo mkdir /mnt/d
		sudo mount -t drvfs D: /mnt/d
	
	To safely unmount

		sudo umount /mnt/d

	You can also mount network shares without smbfs:

		sudo mount -t drvfs '\\server\share' /mnt/share

	ref: https://superuser.com/questions/1114341/windows-10-ubuntu-bash-shell-how-do-i-mount-other-windows-drives

If you get 'qt.qpa.xcb: could not connect to display' error when you attempt to run vorta after a restart of ubuntu/windows...

   back at the Ubuntu command line...
		export DISPLAY=192.168.1.1:0.0  (substitute your IP address from above)
		export LIBGL_ALWAYS_INDIRECT=1

		(same from above)

references:
https://ubuntu.com/tutorials/ubuntu-on-windows#4-install-ubuntu-for-windows-10
https://www.microsoft.com/en-us/p/ubuntu/9nblggh4msv6
https://packages.ubuntu.com/search?keywords=vorta
https://wiki.ubuntu.com/Releases
https://superuser.com/questions/1662669/upgrade-wsl-to-ubuntu-hirsute-21-04-from-20-10
https://superuser.com/questions/1347723/arch-on-wsl-libqt5core-so-5-not-found-despite-being-installed
	https://askubuntu.com/questions/1034313/ubuntu-18-4-libqt5core-so-5-cannot-open-shared-object-file-no-such-file-or-dir
https://sourceforge.net/projects/vcxsrv/
https://github.com/microsoft/WSL/issues/4793
https://superuser.com/questions/1114341/windows-10-ubuntu-bash-shell-how-do-i-mount-other-windows-drives

[m3nu]

That's fine. I'll just add some formatting and put it in the docs. Is it OK to link to your Github profile for credit?

[m3nu]

Now live: https://vorta.borgbase.com/install/windows/

[end-usr2]

This looks great! Thank you for improving the formatting. Sure the link for credit is fine.

Now I just need to get the mount archive working so that I can access my backups. :-) If/when I do, I’ll pass those instructions along as well.

Minor changes:
some ‘$’s are missing
export DISPLAY=192.168.1.1:0.0 (substitute your IP address from above)
export LIBGL_ALWAYS_INDIRECT=1

 sudo mkdir /mnt/d
 sudo mount -t drvfs D: /mnt/d

 sudo umount /mnt/d

 sudo mount -t drvfs '\\server\share' /mnt/share

clarification may be helpful
sudo mkdir /mnt/d (only needed if mount directory doesn’t already exist, eg. first time mounting that drive letter)