Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added instructions to install on Arch #215

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Added instructions to install on Arch #215

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
9e3a2cc
Added instructions to install on Arch
May 3, 2021
13ff3f7
Corrected syntax
goddard-guryon May 3, 2021
bca4c09
Update README.md
Jun 9, 2021
dc5f541
Merge branch 'main' of https://github.com/goddard-guryon/winapps into…
Jun 9, 2021
28523d3
Update README.md
goddard-guryon Jun 27, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 25 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -172,13 +172,36 @@ 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 libguestfs ebtables iptables` using pacman.

- 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`. (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.


## 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)