Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/p1n2o/qemu-termux-alpine


https://github.com/p1n2o/qemu-termux-alpine

Last synced: 21 days ago
JSON representation

Awesome Lists containing this project

README

        

# docker-qemu-arm

Run Docker x86_64 on Android Tablets or Phones

Original idea:

This is a automatic installation script. As RAM is always an issue on a cell phone, we also install zram.

## Android Phone/Tablet with Termux

- Learn about wake locks in Termux:

### Quick Install

```bash
$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/P1N2O/qemu-termux-apline/main/termux-setup.sh)"
# change you alpine root password or run the custom installer!
```

### Custom Install

```bash
$ pkg update
$ pkg install git
$ git clone https://github.com/egandro/docker-qemu-arm.git
$ cd docker-qemu-arm
$ cp config.sample config.env
$ # vi config.env # change everything you want to need to change
$ ./install.sh
```

### Run

```bash
$ $HOME/alpine
$ ./start-qemu.sh
```

## Postinstall & fun

- you can ssh to the VM with a 2nd Terminal and `ssh-qemu.sh` qemukey / qemukey.ssh are the generated SSH keys
- run a `uname -a` and a `docker run hello-world`

## Thanks

- Thanks to everybody who made this happen.

## Known issues

- Alpine Linux & dns & ipv4 only vs ipv4/6 is (very often) broken.
- We pin the dns to `8.8.8.8` (can be changed) and in Alpine we turn off ipv6.

Docker can't connect (for reasons only known to qemu/Alpine/Android/Google)

```bash
alpine:~# docker run hello-world
docker: error during connect: Head "http://%2Fvar%2Frun%2Fdocker.sock/_ping": read unix @->/var/run/docker.sock: read: connection reset by peer.
alpine:~# service docker stop
* Stopping Docker Daemon ... [ ok ]
alpine:~# service docker start
* Starting Docker Daemon ...
```

## Changelog

### 2024/06/28

- updated to latest (stable) Alpine 3.20

### 2024/04/26

- added customizable installer (git checkout)
- updated to latest Alpine 3.19

### 2021/10/07

- added config.env - this makes it much simpler for developers to tweak version numbers
- fixed issue with alpine for zram
- updated to alpine-virt-3.14.0-x86_64.iso