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

docs: add code snipped to enable kvm group permissions #325

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

docs: add code snipped to enable kvm group permissions #325

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b8b166d
docs: add code snipped to enable kvm group permissions
pucke-dev Feb 24, 2023
c34b2cd
docs: re-add linked issue
pucke-dev Feb 24, 2023
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
13 changes: 12 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,18 @@ Default `emulator-options`: `-no-window -gpu swiftshader_indirect -no-snapshot -

The short answer is yes but on Github-hosted Linux runners it's expected to be a much worse experience (on some newer API levels it might not work at all) than running it on macOS, because of the current lack of hardware acceleration support. You can get it running much faster on self-hosted Linux runners but only if the underlying instances support KVM (which most don't). Things might be better on the newer Larger runners but they are still in Beta. It is possible to use this Action with hardware accelerated Linux VMs hosted by a third-party runner provider.

For a longer answer please refer to [this issue](https://github.com/ReactiveCircus/android-emulator-runner/issues/46).
- For a longer answer please refer to [this issue](https://github.com/ReactiveCircus/android-emulator-runner/issues/46).

When using Githubs Larger runners, Actions users will need to add the runner user to the KVM user group:
```
- name: Enable KVM group perms
run: |
echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
sudo udevadm control --reload-rules
sudo udevadm trigger --name-match=kvm
```
You will then be able to make use of hardware acceleration.


## Who is using Android Emulator Runner?

Expand Down