Skip to content

termux/termux-docker

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Termux environment for Docker/Podman.

A Termux environment packaged into Docker image. Environment doesn't have Android runtime components, so certain things will not be available (DalvikVM, OpenSLES, etc...).

How to use

  1. Make sure that Docker is installed and running.
  2. git clone https://github.com/termux/termux-docker && cd ./termux-docker
  3. ./run.sh or ./run-x86_64.sh - if need x86_64 arch.

You can use the image directly without startup script. For example:

docker run -it termux/termux-docker:latest

You can build Docker image yourself by running this script:

./build-all.sh

Using with Podman

If you have Podman instead of Docker, usage is nearly same.

Building image:

./build-all.sh --podman

Running image:

./run.sh --podman
./run-x86_64.sh --podman

Known issues

There a number of known issues which may not be resolved:

  • ARM containers may require a custom seccomp profile to remove restrictions from personality() system call.

  • DNS: Docker image has to use a static DNS resolver through /system/etc/hosts. You can regenerate this file by editing /system/etc/static-dns-hosts.txt and executing script /system/bin/update-static-dns.

  • When running certain multi threaded program in 32bit containers, the PIDs can balloon and easily exceed libc's limit. The only way to fix this is to set /proc/sys/kernel/pid_max to 65536. See termux-docker#40.

About

Termux environment packaged as Docker image.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published