From 9e3a2cc3b8ff87f33b7b1064b08ec6816e8d82b0 Mon Sep 17 00:00:00 2001 From: Goddard Guryon Date: Mon, 3 May 2021 18:06:55 +0530 Subject: [PATCH 1/4] Added instructions to install on Arch Even though winapps is not officially supported on Arch, its installation is quite easy. You just need to do a few extra steps, which I have added at the bottom of the readme. This should get winapps to work on almost all Arch installations. --- README.md | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index cdef984..9741527 100644 --- a/README.md +++ b/README.md @@ -172,13 +172,38 @@ The following optional commands can be used to manage your application configura ./installer.sh --system --uninstall # Remove all configured applications for the entire system ``` +## Installation on Arch Linux +Although WinApps is not officially supported on Arch Linux, it is still quite easy to get it working with a few minor tweaks. Installing winapps on Arch requires a few additional steps to configure the setup properly: + +- **Installing KVM**: if you don't have KVM installed along with `virt-manager` (`virt-manager` will default to LXC connection if QEMU is not installed), follow these steps: + + - Install the required packages: `qemu virt-manager virt-viewer dnsmasq vde2 bridge-utils openbsd-netcat ebtables iptables` using pacman. + + - Install `libguestfs` using the AUR helper you have, such as `yaourt` or `yay` (if you don't have any helper installed, check Arch wiki on instructions regarding its installation). + + - Edit the file `/etc/libvirt/libvirtd.conf` as follows: + + - Change the `unix_sock_group` to `"libvirt"` + + - Set the `unix_sock_rw_perms` to `"0770"` + + - Add your user account to libvirt group using `usermod -a -G libvirt $(whoami)` (if the group doesn't exist, create it using `newgrp libvirt`). + + - After this, you can follow the instructions in the [KVM installation guide](docs/KVM.md) to install Windows VM. + +- **Installing WinApps**: Before you follow the guide above to install winapps normally, make sure to set the following configurations: + + - Create a file `~/.config/libvirt/libvirt.conf` and add a single line in it: `uri_default = qemu:///system`. This allows you to run the VM and winapps without using `sudo`. + + - Run the command `virsh net-autostart default` to make sure that the 'default' connection is started after every reboot on Arch. + + ## Common issues - **Black window**: This is a FreeRDP bug that sometimes comes up. Try restarting the application or rerunning the command. If that doesn't work, ensure you have `MULTIMON` disabled. ## Shout outs - Some icons pulled from - - Fluent UI React - Icons under [MIT License](https://github.com/Fmstrat/fluent-ui-react/blob/master/LICENSE.md) + - Fluent UI React - Icons under [MIT License](https://github.com/Fmstrat/fluent-ui-react/blob/master/LICENSE.md) - Fluent UI - Icons under [MIT License](https://github.com/Fmstrat/fluentui/blob/master/LICENSE) with [restricted use](https://static2.sharepointonline.com/files/fabric/assets/microsoft_fabric_assets_license_agreement_nov_2019.pdf) - PKief's VSCode Material Icon Theme - Icons under [MIT License](https://github.com/Fmstrat/vscode-material-icon-theme/blob/master/LICENSE.md) - DiemenDesign's LibreICONS - Icons under [MIT License](https://github.com/Fmstrat/LibreICONS/blob/master/LICENSE) - From 13ff3f7a314403a94fd55df1ce95adf209c021b0 Mon Sep 17 00:00:00 2001 From: Goddard Guryon <9369053+goddard-guryon@users.noreply.github.com> Date: Mon, 3 May 2021 21:42:24 +0530 Subject: [PATCH 2/4] Corrected syntax --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9741527..bf0f487 100644 --- a/README.md +++ b/README.md @@ -193,7 +193,7 @@ Although WinApps is not officially supported on Arch Linux, it is still quite ea - **Installing WinApps**: Before you follow the guide above to install winapps normally, make sure to set the following configurations: - - Create a file `~/.config/libvirt/libvirt.conf` and add a single line in it: `uri_default = qemu:///system`. This allows you to run the VM and winapps without using `sudo`. + - Create a file `~/.config/libvirt/libvirt.conf` and add a single line in it: `uri_default = "qemu:///system"`. This allows you to run the VM and winapps without using `sudo`. - Run the command `virsh net-autostart default` to make sure that the 'default' connection is started after every reboot on Arch. From bca4c090bce21d7f72f4abd4340e4c1faf6e8fdd Mon Sep 17 00:00:00 2001 From: Goddard Guryon Date: Wed, 9 Jun 2021 17:47:03 +0530 Subject: [PATCH 3/4] Update README.md libguestfs is in official repos, no need to use AUR helper for it --- README.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/README.md b/README.md index 9741527..3bcf18c 100644 --- a/README.md +++ b/README.md @@ -177,9 +177,7 @@ Although WinApps is not officially supported on Arch Linux, it is still quite ea - **Installing KVM**: if you don't have KVM installed along with `virt-manager` (`virt-manager` will default to LXC connection if QEMU is not installed), follow these steps: - - Install the required packages: `qemu virt-manager virt-viewer dnsmasq vde2 bridge-utils openbsd-netcat ebtables iptables` using pacman. - - - Install `libguestfs` using the AUR helper you have, such as `yaourt` or `yay` (if you don't have any helper installed, check Arch wiki on instructions regarding its installation). + - Install the required packages: `qemu virt-manager virt-viewer dnsmasq vde2 bridge-utils openbsd-netcat libguestfs ebtables iptables` using pacman. - Edit the file `/etc/libvirt/libvirtd.conf` as follows: From 28523d3d1c41873c161e0622a70cb0051b80dd3d Mon Sep 17 00:00:00 2001 From: Goddard Guryon <9369053+goddard-guryon@users.noreply.github.com> Date: Sun, 27 Jun 2021 20:12:26 +0530 Subject: [PATCH 4/4] Update README.md Probably permission structure is a bit different in Manjaro, due to which one of the steps is not required there. So I updated the file to make it clearer. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9de1190..4d60b08 100644 --- a/README.md +++ b/README.md @@ -191,7 +191,7 @@ Although WinApps is not officially supported on Arch Linux, it is still quite ea - **Installing WinApps**: Before you follow the guide above to install winapps normally, make sure to set the following configurations: - - Create a file `~/.config/libvirt/libvirt.conf` and add a single line in it: `uri_default = "qemu:///system"`. This allows you to run the VM and winapps without using `sudo`. + - Create a file `~/.config/libvirt/libvirt.conf` and add a single line in it: `uri_default = "qemu:///system"`. This allows you to run the VM and winapps without using `sudo`. (This assumes that the user has performed the previous steps as super user. In case performing this step stops `virt-manager` from accessing the VM, but removing the `libvirt.conf` file lets it work, then skip this step). - Run the command `virsh net-autostart default` to make sure that the 'default' connection is started after every reboot on Arch.