cyberkernelofficial / docker-in-termux Goto Github PK

View Code? Open in Web Editor NEW

199.0 3.0 20.0 19 KB

This repository contains instructions on how to install Docker in Termux, without root.

License: MIT License

docker termux termux-tool termux-tools docker-in-termux

docker-in-termux's Introduction

Installing Docker in Termux

This repository contains instructions on how to install Docker in Termux, a powerful terminal emulator for Android.

Prerequisites

Before proceeding with the installation, make sure you have the following prerequisites:

An Android device with Termux installed. You can download Termux from the F-Droid app store.
Stable internet connection.

Installation Steps

Follow the steps below to install Docker in Termux:

Open Termux on your Android device.
Update and upgrade the packages by running the following command:

pkg update -y && pkg upgrade -y

Install the necessary dependencies by running the following command:

pkg install qemu-utils qemu-common qemu-system-x86_64-headless wget -y

Create a seperate directory:

mkdir alpine && cd alpine

Download Alpine Linux 3.19 (virt optimized) ISO:

wget http://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.1-x86_64.iso

Create disk (note it won't actually take 5GB of space, more like 500-600MB):

qemu-img create -f qcow2 alpine.img 5G

Boot it up:

qemu-system-x86_64 -machine q35 -m 1024 -smp cpus=2 -cpu qemu64 -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd -netdev user,id=n1,dns=8.8.8.8,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 -cdrom alpine-virt-3.19.1-x86_64.iso -nographic alpine.img

Login with username root (no password)
Setup network (press Enter to use defaults):

localhost:~# setup-interfaces
 Available interfaces are: eth0.
 Enter '?' for help on bridges, bonding and vlans.
 Which one do you want to initialize? (or '?' or 'done') [eth0]
 Ip address for eth0? (or 'dhcp', 'none', '?') [dhcp]
 Do you want to do any manual network configuration? [no]

localhost:~#

ifup eth0

Create an answerfile to speed up installation:

wget https://raw.githubusercontent.com/cyberkernelofficial/docker-in-termux/main/answerfile

NOTE: If you see any error like this: wget: bad address 'gist.githubusercontent.com'. Then run this command
echo -e "nameserver 192.168.1.1\nnameserver 1.1.1.1" > /etc/resolv.conf

Patch setup-disk to enable serial console output on boot:

sed -i -E 's/(local kernel_opts)=.*/\1="console=ttyS0"/' /sbin/setup-disk

Run setup to install to disk

setup-alpine -f answerfile

Once installation is complete, power off the VM (command poweroff)
Boot again without cdrom:

qemu-system-x86_64 -machine q35 -m 1024 -smp cpus=2 -cpu qemu64 -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd -netdev user,id=n1,dns=8.8.8.8,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 -nographic alpine.img

A - nano run_qemu.sh In the text editor, write the following:

#!/bin/bash
qemu-system-x86_64 -machine q35 -m 1024 -smp cpus=2 -cpu qemu64 -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd -netdev user,id=n1,dns=8.8.8.8,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 -nographic alpine.img

Save and close the file. In nano, you can do this by pressing Ctrl+X, then Y to confirm saving, and then Enter to confirm the filename.

B - chmod command: chmod +x run_qemu.sh

C - ./run_qemu.sh

Update system and install docker:

echo "nameserver 8.8.8.8" > /etc/resolv.conf
echo "nameserver 8.8.4.4" >> /etc/resolv.conf

apk update && apk add docker

Start docker:

service docker start

Enable docker on boot:

rc-update add docker

Check docker install successfully or not:

docker run hello-world

Some useful keys

Ctrl+a x: quit emulation
Ctrl+a h: toggle QEMU console

Usage

Now that Docker is installed in Termux, you can start using it to manage and run containers on your Android device. Refer to the official Docker documentation for more information on how to use Docker.

Contributing

If you encounter any issues during the installation process or have suggestions for improvements, please feel free to open an issue or submit a pull request.

Acknowledgment

This article inspired from: https://gist.github.com/oofnikj/e79aef095cd08756f7f26ed244355d62

License

This project is licensed under the MIT License.

docker-in-termux's People

Contributors

Stargazers

Watchers

docker-in-termux's Issues

Help with VNC connection

I'm stuck in part 7: qemu-system-x86_64 -machine q35 -m 1024 -smp cpus=2 -cpu qemu64 -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd -netdev user,id=n1,dns=8.8.8.8,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 -cdrom alpine-virt-3.19.0-x86_64.iso -nographic alpine.img

When I run the command above it says: VNC server running on 127.0.0.1:5900

But I can't access the VNC server using a VNC viewer from my PC using the 192.168.100.X ... address

Am I missing something ?

How to visit my web service running as a container inside alpine from Termux?

I successfully run Docker according to the excellent tutorial.

But I can not visit my web service runing as a container inside alpine, whose port is 5244.

Can't reach the registry

Good day

I managed to follow the instructions and install docker yesterday. Everything was working fine and I even got hello-world to work. but today I keep getting this error every time I try to search or pull an image.

docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": dial tcp: lookup registry-1.docker.io on 8.8.8.8:53: read udp 10.0.2.15:36190->8.8.8.8:53: i/o timeout.

Very slow read speed on the qemu image

I noticed massive read speed reduction (like 10-20 times) when inside qemu this makes building/pulling images take hours.
Do you have any improvements that can be made here?

I tested with this script https://github.com/thodnev/MonkeyTest/blob/master/monkeytest.py
inside termux i get normal 90MB/s but inside qemu i get 4MB/s.
I tried my best to fix this bottlneck best i got is 10MB/s by using .raw image format instead of Qcow2

Unable to boot [after improper shutdown]; VFS: Unable to mount root fs

Hi,
I am getting this error while trying to boot. (FYI: after unexpected shutdown [low battery/ power off] ; apk was running so this happened) ... Is there a way how to fix it?
Thanks a lot in advance.

Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0) ]---

VFS: Cannot open root device
or unknown-block(0,0): error -19
Please append a correct "root=" boot option; here are the available partitions:
[ 5.022423] Can't find any bdev filesystem to be used for mount!
[ 5.024308] Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0)
[ 5.027323] CPU: 0 PID: 1 Comm: swapper/0 Not tainted 6.6.49-0-virt #1-Alpine

Any instructions for temoving alpine linux and docker for termux?

Are there any instructions for temoving alpine linux and docker for termux?... or do I need to uninstall termux and start from scratch? Or is it safe to just remove the alpine image files? (OR does it put fikes elsewhere when installed using the instructions on guthub at
" https://github.com/cyberkernelofficial/docker-in-termux "

Thanks.

QEMU Stuck on "Booting Linux virt" When Starting Alpine Linux

I am attempting to run Alpine Linux (version 3.19.1) using QEMU on my system, but the boot process is continuously stuck at "Booting Linux virt".
I run qemu-system-x86_64 -machine q35 -m 1024 -smp cpus=2 -cpu qemu64 -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd -netdev user,id=n1,dns=8.8.8.8,hostfwd=tcp::2222-:22 -device virtio-net,netdev=n1 -cdrom alpine-virt-3.19.1-x86_64.iso -nographic alpine.img