Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Vanilla-OS/waydroid-image
Containerfile for building a Waydroid image.
https://github.com/Vanilla-OS/waydroid-image
containers hacktoberfest images oci-images vanillaos
Last synced: 24 days ago
JSON representation
Containerfile for building a Waydroid image.
- Host: GitHub
- URL: https://github.com/Vanilla-OS/waydroid-image
- Owner: Vanilla-OS
- License: gpl-3.0
- Created: 2023-08-29T06:58:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-26T08:30:07.000Z (3 months ago)
- Last Synced: 2024-08-26T10:47:29.795Z (3 months ago)
- Topics: containers, hacktoberfest, images, oci-images, vanillaos
- Language: Shell
- Homepage:
- Size: 34.2 KB
- Stars: 13
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Waydroid Image
Containerfile for building a Waydroid image.
This image is based on top of [`vanillaos/pico`](https://github.com/Vanilla-OS/core-image/pkgs/container/pico) and offers a Waydroid
installation.
> [!NOTE]
> This is an experimental image providing Waydroid via Apx (`distrobox`). It still requires the `binder_linux` kernel module at the host side.
## Build
### Requirements
- [Vib](https://github.com/Vanilla-OS/Vib)
- Podman or Docker
## Build the image
```bash
vib build recipe.yml
podman image build -t vanillaos/waydroid .
```
## Run
### Requirements
- Podman or Docker
- [Distrobox](https://github.com/89luca89/distrobox) (suggested) [1](#note1)
- [binder_linux](https://github.com/choff/anbox-modules) installed on host
### Usage
> Currently, the container needs to be rootfull, since it has to modprobe the needed kernel
> modules and mount the binder filesystem. This could change in the future.
```bash
distrobox create --root --init --unshare-all -i ghcr.io/vanilla-os/waydroid:main -n waydroid # replace with your local image if you built it
distrobox enter --root waydroid
```
Wait for the `waydroid-init` service to end, check with `systemctl status waydroid-init`.
Then start using waydroid with [2](#note2):
```bash
ewaydroid --help
```
## Note
- 1: At the time of writing, the `--unshare-all` option is not yet released
so you need to use the latest version from git.
- 2: The `ewaydroid` script is a wrapper around `waydroid` that
automatically points the `XDG_RUNTIME_DIR` and `DBUS_SESSION_BUS_ADDRESS` environment
variables to the host ones. This is needed to make the waydroid services work by
properly communicating with the host.