Skip to content

Repository files navigation

ternux

A GPU-accelerated Linux workstation on the phone already in your pocket.

Termux + PRoot Debian + Xfce4, with Vulkan through Zink / Turnip on supported Adreno devices and VirGL as the compatibility path. No root.

site licence platform

English · বাংলা

Website · Get ternux · Usage · ternux Pro


What this project is

ternux documents and productises a genuinely useful Debian/Xfce4 workstation on Android. The desktop runs in a PRoot container, displays through Termux:X11 and uses a GPU-backed Mesa path where the device supports it.

The public repository covers:

  • Architecture, compatibility and realistic device limits
  • Daily operation, health checks and troubleshooting
  • Workload guidance for lightweight Blender, local AI, development and authorised security labs
  • The scope, release plan and transparent limitations of ternux Pro

The complete Pro installer, deployment implementation and recovery runbook are private release materials. This repository does not publish the full installation recipe or host an unofficial installer endpoint.

Proven and practical workloads

  • Everyday Linux: Xfce4, terminal, Git, editors, archives and light browsing
  • Lightweight Blender: low-poly modelling, simple materials and modest scenes; author-reported as smooth enough to be useful on the tested Turnip-enabled device
  • Local AI: Vulkan-enabled llama.cpp with compact 1–2B Q4 GGUF models as a practical phone-sized starting point
  • Development: Node.js/npm and terminal-based coding assistants, subject to each provider's account and licence terms
  • Defensive security lab: network discovery, packet analysis, web assessment and password auditing on systems you own or are authorised to test

This is still a phone. Heavy rendering, large simulations, oversized model contexts and sustained mining are poor fits because RAM, thermals and battery remain hard limits.

Device baseline

Recommended baseline
OS Android 10 or newer
CPU aarch64 / 64-bit ARM
Storage 12 GB free for the base environment; more for models/projects
RAM 4 GB minimum in practice; 6–8 GB preferred
Graphics Adreno for Zink + Turnip; VirGL compatibility on other GPUs
Apps Maintained Termux from F-Droid/GitHub, plus Termux:X11

The abandoned Play Store build of Termux is not supported.

Documentation

Document Purpose
Get ternux Readiness, compatibility, private deployment overview and what to do after setup
ternux Pro Product scope, private docs set, workload profiles and release milestones
Usage Daily controls, Blender, local AI, development and authorised security workflows
Support & diagnostics Symptom classification, safe reports and the public/private recovery boundary
Configuration Environment variables, cache and backend behaviour
Architecture How Termux, PRoot, X11 and Mesa fit together
FAQ Root, battery, storage and device limitations

ternux Pro

ternux Pro is in private development and is not yet on sale. It is designed as a verified, resumable and diagnosable deployment with curated workload profiles and version-matched private operator documentation.

There is no public installer URL today. Treat copied download links or commands claiming otherwise as untrusted. Watch this repository for the private beta and official release channel.

Responsible use

Security tools are documented for defensive work and controlled labs. Use them only on devices, applications and networks you own or have explicit permission to test. Android/PRoot does not provide unrestricted radio, monitor-mode or USB access.

Never publish licence keys, API tokens, model-provider credentials or private support bundles in an issue.

Contributing

Corrections and device-specific observations are welcome—especially renderer evidence, known Android/OEM limitations and reproducible workload findings. See CONTRIBUTING.md.

Do not submit proprietary installer code, private endpoints, licence material or full Pro deployment procedures to this public repository.

Licence

Public documentation is MIT. ternux Pro, its installer and its private documentation are proprietary and separate.

Not affiliated with Termux, Debian, Xfce, Blender, Qualcomm or any third-party tool named in the documentation.


Built by Sobuj Miah (@soobujmiah)

Copyright © 2026 Sobuj Miah · public documentation MIT licensed

About

A GPU-accelerated Linux desktop on your Android phone. Termux + PRoot Debian + Xfce4, with Zink/Turnip Vulkan acceleration. No root.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages