Fabio/qemu-arm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: Readme

Browse source 
* docs: Readme
This commit is contained in:
Kroese 2024-01-04 05:13:06 +01:00 committed by GitHub
parent ba6429def3
commit 87f926498f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 11 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docker-compose.yml
View file

@ -8,15 +8,15 @@ services:
RAM_SIZE: "1G" RAM_SIZE: "1G"
CPU_CORES: "1" CPU_CORES: "1"
DISK_SIZE: "16G" DISK_SIZE: "16G"
BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.18/releases/x86_64/alpine-standard-3.18.2-x86_64.iso" BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.0-x86_64.iso"
devices: devices:
- /dev/kvm - /dev/kvm
device_cgroup_rules: device_cgroup_rules:
- 'c *:* rwm' - 'c *:* rwm'
cap_add: cap_add:
- NET_ADMIN - NET_ADMIN
ports: ports:
- 2222:22 - 2222:22
- 5900:5900 - 5900:5900
restart: on-failure stop_grace_period: 2m
stop_grace_period: 1m restart: unless-stopped

13
readme.md
View file

@ -33,7 +33,7 @@ services:
image: qemux/qemu-docker:latest image: qemux/qemu-docker:latest
environment: environment:
DISPLAY: "vnc" DISPLAY: "vnc"
BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.18/releases/x86_64/alpine-standard-3.18.2-x86_64.iso" BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.0-x86_64.iso"
devices: devices:
- /dev/kvm - /dev/kvm
cap_add: cap_add:
@ -41,13 +41,14 @@ services:
ports: ports:
- 2222:22 - 2222:22
- 5900:5900 - 5900:5900
restart: on-failure stop_grace_period: 2m
restart: unless-stopped
``` ```
Via `docker run` Via `docker run`
```bash ```bash
docker run -it --rm -e "BOOT=http://www.example.com/image.iso" -p 5900:5900 --device=/dev/kvm --cap-add NET_ADMIN qemux/qemu-docker:latest docker run -it --rm -e "DISPLAY=vnc" -e "BOOT=http://example.com/image.iso" -p 5900:5900 --device=/dev/kvm --cap-add NET_ADMIN qemux/qemu-docker:latest
``` ```
## FAQ ## FAQ
@ -58,7 +59,7 @@ docker run -it --rm -e "BOOT=http://www.example.com/image.iso" -p 5900:5900 --de
```yaml ```yaml
environment: environment:
BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.18/releases/x86_64/alpine-standard-3.18.2-x86_64.iso" BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.0-x86_64.iso"
``` ```
It will be downloaded only once, during the initial run of the container. It will be downloaded only once, during the initial run of the container.
@ -106,7 +107,7 @@ docker run -it --rm -e "BOOT=http://www.example.com/image.iso" -p 5900:5900 --de
sudo kvm-ok sudo kvm-ok
``` ```
If you receive an error from `kvm-ok` indicating that KVM acceleration can't be used, check your BIOS settings. If you receive an error from `kvm-ok` indicating that KVM acceleration can't be used, check the virtualization settings in the BIOS.
* ### How do I assign an individual IP address to the container? * ### How do I assign an individual IP address to the container?
@ -172,7 +173,7 @@ docker run -it --rm -e "BOOT=http://www.example.com/image.iso" -p 5900:5900 --de
Afterwards you can connect with any VNC client to port 5900. Afterwards you can connect with any VNC client to port 5900.
* ### How do I boot via UEFI? * ### How do I boot with UEFI?
To enable UEFI booting, add the following line to your compose file: To enable UEFI booting, add the following line to your compose file: