ইনস্টলেশন

এটি সম্পূর্ণ গাইড। সংক্ষিপ্ত পথ চাইলে শুরু করুন দ্রুত শুরু থেকে।

প্রতিটি কমান্ড নিজ হাতে চালাতে চান? সম্পূর্ণ হাতে-কলমে নির্দেশিকা — প্রতিটি কমান্ড, দুই GPU পথ, পুরো লঞ্চার ফাইল — আছে ম্যানুয়াল ইনস্টলেশন পাতায়। নিচের এক-কমান্ড ইনস্টলারটি সেই একই পাতাই, স্ক্রিপ্ট আকারে।

প্রয়োজনীয়তা

শুরু করার আগে ডিভাইস পরীক্ষা করুন (শুধু পড়ে, কিছুই বদলায় না):

uname -m                              # আশা: aarch64
getprop ro.product.manufacturer       # যেমন Qualcomm
getprop ro.product.model
getprop ro.build.version.release      # যেমন 14
df -h "$HOME"                         # ফাঁকা জায়গা
ls -l /dev/kgsl-3d0 2>&1              # থাকলে → Adreno → Zink/Turnip পথ

/dev/kgsl-3d0 থাকলে ইনস্টলার দ্রুত Zink/Turnip পথ বেছে নেবে। না থাকলে VirGL সামঞ্জস্য পথ। এর acceleration, feature coverage ও গতি ডিভাইসভেদে যাচাই করতে হবে।

উপরের storage সংখ্যা আনুমানিক installed footprint, temporary headroom-এর minimum নয়। Package version ও filesystem accounting বদলায়। Clean run-এর জন্য installer base-এ প্রায় ৬ GB free এবং --all-এ ১৪ GB free target করে, যাতে download, cache, extraction ও build-এর জায়গা থাকে; finished installation যথাক্রমে প্রায় ৩–৪ GB ও ১০–১২ GB।

পদ্ধতি ১ — এক কমান্ড (প্রস্তাবিত)

curl -fsSL https://soobujmiah.github.io/ternux/install.sh | bash

এটি HTTPS-এ ইনস্টলার নামিয়ে চালায়। এই রিপোজিটরির সেই একই স্ক্রিপ্ট — লুকানো কিছু নেই, কম্পাইলড কিছু নেই।

ইনস্টলার একটিমাত্র স্থায়ী স্ক্রিন আঁকে — device panel, step progress, live log window ও অতিবাহিত সময় — এবং শেষ status পর্যন্ত সেটিই রাখে। Package output spinner-এর আড়ালে না রেখে যেমন আসে তেমন দেখানো হয়, আর terminal যা-ই আঁকতে পারুক, প্রতিটি লাইন লগ ফাইলে লেখা হয়। রেন্ডারার mode ও সেগুলো বদলানোর উপায় ইনস্টলার স্ক্রিন-এ আছে।

Standalone loader bounded retry-সহ একটি validated source snapshot নামায়, তারপর আলাদা করে প্রতিটি module request না করে bootstrap library, Termux host CLI ও Debian guest companion-এর জন্য একই snapshot reuse করে। Package setup বর্তমান apt source-ই রাখে এবং frame-এর ভেতর termux-change-repo খোলে না; source unreachable হলে নিজে mirror বেছে --resume দিয়ে আবার চালান।

আপগ্রেডের পর curl ভেঙে গেছে? (CANNOT LINK … SSL_set_quic_tls_transport_params) আংশিক আপগ্রেডে curl ও openssl সামঞ্জস্য হারিয়েছে। wget ব্যবহার করুন — একই ইনস্টলার, আর স্ক্রিপ্ট আপনার curl নিজেই মেরামত করে দেবে:

wget -qO- https://soobujmiah.github.io/ternux/install.sh | bash

পদ্ধতি ২ — সব executable অংশ পড়ুন, তারপর চালান

শুধু standalone install.sh পড়া পূর্ণ review নয়—চালু হলে সেটি সম্পূর্ণ repository snapshot নামিয়ে source করে। তাই entry point ও source-করা library-গুলো একসঙ্গে clone করে দেখুন:

pkg update -y && pkg install git -y
git clone https://github.com/soobujmiah/ternux.git
cd ternux
git log -1 --oneline                 # exact commit লিখে রাখুন
(set -e; for f in install.sh uninstall.sh bin/ternux bin/ternux-guest lib/*.sh; do bash -n "$f"; done)
less install.sh lib/core.sh lib/phases.sh lib/detect.sh lib/ui.sh
# less-এ :n দিলে পরের file, q দিলে review শেষ হবে।
bash install.sh

Reproducible review-এর জন্য git fetch --tags চালিয়ে release tag checkout করুন এবং inspection-এর আগে git status --short ফাঁকা আছে কি না দেখুন। Installed result একই হওয়ার কথা; local review route একবার confirmation চাইতে পারে। Review-এর পর prompt না চাইলে সচেতনভাবে --yes দিন। বিঘ্নিত হলে bash install.sh --resume চালান; successful হিসেবে recorded phase বাদ যাবে এবং interrupted run-এর saved optional workload set restore হবে।

পদ্ধতি ৩ — সম্পূর্ণ ম্যানুয়াল, কমান্ডে কমান্ডে

সম্পূর্ণ নিয়ন্ত্রণ চাইলে — বা ইনস্টলার নিজেই ডিবাগ করতে হলে — ম্যানুয়াল ইনস্টলেশন পাতায় প্রতিটি কমান্ড খোলাসা করে আছে: বেস প্যাকেজ, কন্টেইনার, দুই পথের GPU ড্রাইভার, সম্পূর্ণ ~/x.sh লঞ্চার ফাইল ও যাচাইকরণ। পদ্ধতি ১ ও ২ আপনার জন্য সেই একই ধাপগুলোই চালায়।

ternux CLI — host control ও guest diagnostics

ইনস্টলের পর দুই terminal environment-এই ternux পাওয়া যায়, তবে entry point দুটির দায়িত্ব ইচ্ছাকৃতভাবে আলাদা:

পূর্ণ control plane Termux host terminal-এ ব্যবহার করুন:

command -v ternux       # $PREFIX/bin/ternux
ternux --version        # ternux vX.Y.Z
ternux doctor           # সিস্টেম ডায়াগনস্টিক
ternux doctor --json    # machine-readable output
ternux start            # ডেস্কটপ চালু
ternux stop             # ডেস্কটপ বন্ধ
ternux restart          # ডেস্কটপ পুনরায় চালু
ternux repair           # সাধারণ সমস্যা সমাধান
ternux verify           # ইনস্টলেশন যাচাই
ternux benchmark        # GPU বেঞ্চমার্ক
ternux profile          # ডিভাইস প্রোফাইল
ternux backend          # GPU ব্যাকএন্ড ব্যবস্থাপনা
ternux info             # সিস্টেম তথ্য
ternux info --json      # machine-readable তথ্য
ternux logs             # লগ দেখা
ternux state            # ইনস্টলেশন অবস্থা
ternux update           # CLI আপডেট
ternux uninstall        # কম্পোনেন্ট অপসারণ

Debian-এর Xfce terminal থেকে guest-local inspection চালান:

command -v ternux       # /usr/local/bin/ternux
ternux --version        # ternux guest vX.Y.Z
ternux status
ternux info
ternux doctor
ternux env

Guest companion start, stop, repair, update, uninstall-এর মতো host-only lifecycle command-এ usage error দিয়ে Termux-এ চালাতে বলে; এতে accidental nested PRoot session হয় না। Installer exact installed host ও guest command execute করে version response যাচাই করে—শুধু executable file থাকা success নয়।

Host dispatcher global flag শনাক্ত করে, কিন্তু সব command JSON schema দেয় না। Structured output শুধু CLI reference-এ নথিভুক্ত command-এ ব্যবহার করুন।

ইনস্টলার যা করে (এবং কেন, ধাপে ধাপে)

ইনস্টলার এগারোটি যাচাইকৃত ধাপে সাজানো। প্রতিটি ধাপ পরেরটি শুরুর আগে নিজের কাজ যাচাই করে — ব্যর্থ ধাপ স্পষ্ট বার্তায় ইনস্টল থামিয়ে দেয়, “প্রায় চলে” এমন অর্ধভাঙা ডেস্কটপ রেখে যায় না।

ইনস্টলার অপশন

bash install.sh                     # ইন্টারঅ্যাক্টিভ — বড় ধাপের আগে প্রশ্ন করে
bash install.sh --yes               # সব ডিফল্ট মেনে নেয়, প্রশ্ন নেই
bash install.sh --user soobuj       # Debian ইউজারনাম (ডিফল্ট: ternux)
bash install.sh --locale bn_BD.UTF-8
bash install.sh --backend zink      # Zink/Turnip বাধ্যতামূলক (শুধু Adreno)
bash install.sh --backend virgl     # VirGL সামঞ্জস্য পথ বাধ্যতামূলক
bash install.sh --zsh               # Termux শেলও zsh-এ বদলান
bash install.sh --with-dev          # Git, Node.js, Python, বিল্ড টুলস
bash install.sh --with-llm          # llama.cpp + Vulkan (লোকাল AI)
bash install.sh --with-network      # nmap, tmux (শুধু অনুমোদিত পরীক্ষা)
bash install.sh --with-media        # ffmpeg, GIMP, Audacity, ImageMagick
bash install.sh --with-blender      # Blender (হালকা সিন)
bash install.sh --all               # সব ঐচ্ছিক প্রোফাইল
bash install.sh --resume            # বিঘ্নের পর আবার চালু
bash install.sh --version | --help

ইনস্টলের পর ternux CLI ব্যবহার করুন ডায়াগনস্টিক ও ব্যবস্থাপনার জন্য:

ternux doctor           # ডায়াগনস্টিক (bash install.sh --doctor এর বদলে)
ternux repair           # ডায়াগনস্টিক ও মেরামত (--doctor --fix এর বদলে)
ternux state            # কী হয়েছে, কী বাকি (--status এর বদলে)
ternux uninstall        # অপসারণ (--uninstall এর বদলে)
ternux update           # CLI আপডেট

GPU ব্যাকএন্ড বাছাই

/dev/kgsl-3d0-বিহীন ডিভাইসে zink জোর করলে GPU phase-এ launcher তৈরির আগেই স্পষ্টভাবে ব্যর্থ হয়—নিঃশব্দে software desktop বানায় না। এই ব্যর্থতা ইচ্ছাকৃত।

ইনস্টলার স্ক্রিন

পুরো ইনস্টলের জন্য একটিই স্ক্রিন। Log window-তে চলমান ফেজের live tail থাকে; পুরো স্ট্রিম সবসময় লগ ফাইলে যোগ হয়।

+=========================================================+
|           ternux v1.4.0 - ONE-CLICK INSTALLER           |
| by Sobuj Miah  -  base ~3-4 GB  -  complete ~10-12 GB   |
+=========================================================+
| Device    Redmi Turbo 4 Pro - Android 15 (SDK 35)       |
| Graphics  Adreno 825 - backend zink - Vulkan 1.4        |
| Memory    12 GB RAM - 84 GB free - aarch64              |
| STEPS 4/11  ######------------  Debian container        |
+=========================================================+
| Get:14 http://deb.debian.org bookworm/main arm64        |
| Unpacking xfce4-session (4.18.3-1) ...                  |
|     ... +201 more lines (full log: ternux.log)          |
| [ OK ] Base packages installed                          |
+=========================================================+
| (c) 2026 Sobuj Miah - github.com/soobujmiah  03:12 /    |
+=========================================================+

রেন্ডারার mode

নির্বাচন স্বয়ংক্রিয়; অন্য ফল চাইলে নিজে ঠিক করে দিন:

bash install.sh --plain          # স্ক্রলিং লগ, ফুল-স্ক্রিন ড্যাশবোর্ড নয়
bash install.sh --no-anim        # ড্যাশবোর্ড, কিন্তু স্পিনার বা রঙ বদল ছাড়া
TERNUX_UI=off bash install.sh    # সরাসরি আউটপুট, যেমন transcript রাখতে

লগ উইন্ডো পড়া

• apt, dpkg, proot-distro ও curl-এর carriage-return প্রগ্রেস একটি সারিতেই হালনাগাদ হয়, উইন্ডো ভাসিয়ে নিয়ে যায় না।
• কোনো ফেজ পড়ার চেয়ে দ্রুত লিখলে নতুন লাইনগুলো রাখা হয় আর বাকিগুলোর সংখ্যা ... +201 more lines হিসেবে জানানো হয়। Error, warning ও phase চিহ্ন কখনো সংক্ষেপ করা হয় না।
• ফন্টের মাপ বদলালে, ডিভাইস ঘোরালে বা অন-স্ক্রিন কীবোর্ড খুললে ফ্রেম একবার নতুন মাপে বসে এবং দৃশ্যমান লগ আবার আঁকা হয়।
• Ctrl-C terminal ফিরিয়ে দেয় এবং রেকর্ড করা state রেখে যায়, তাই bash install.sh --resume শেষ সম্পন্ন ফেজ থেকে চলতে থাকে।

কী রেকর্ড হবে তা রেন্ডারার ঠিক করে না:

ternux logs tail     # চলমান ইনস্টল লগ দেখুন
ternux logs show     # পুরো লগ পড়ুন
ternux logs list     # লগ ফাইল ও আকার

ইনস্টলের পর

1. Termux:X11 একবার খুলে চালু রাখুন।
2. source ~/.bashrc
3. x                 ← ডেস্কটপ চালু হয়

সম্পূর্ণ ডায়াগনস্টিক চালান:

ternux doctor
ternux doctor --json    # machine-readable output

তারপর ডেস্কটপের টার্মিনাল থেকে গ্রাফিক্স পথ যাচাই করুন:

glxinfo | grep "renderer string"
vulkaninfo --summary | grep -i driverName     # Adreno: আশা "Turnip"

বড় মডেল বা পরীক্ষামূলক প্যাকেজ যোগের আগে চালু অবস্থার ব্যাকআপ নিন:

proot-distro backup debian --output ~/debian-backup.tar.gz

আপডেট

• ternux CLI: ternux update GitHub থেকে সর্বশেষ ভার্সন নিয়ে আসে।
• Interrupted installer run: একই reviewed script আবার download করে --resume দিন; শুধু successful হিসেবে recorded phase বাদ যাবে। এটি completed phase update/repair করে না—CLI-এর জন্য ternux update, managed artifact-এর জন্য ternux repair ব্যবহার করুন। গুরুত্বপূর্ণ data আগে backup নিন।
• Debian প্যাকেজ: ডেস্কটপে sudo apt update && sudo apt upgrade। Zink পথে Mesa প্যাকেজ ইচ্ছাকৃতভাবে হোল্ড করা (apt-mark hold) — আপগ্রেডে নিঃশব্দে সফটওয়্যার রেন্ডারিংয়ে ফিরে যাওয়া ঠেকাতে। ইচ্ছা করে আনহোল্ড করুন: sudo apt-mark unhold mesa-vulkan-drivers libgl1-mesa-dri libglx-mesa0 libgbm1 libegl-mesa0।

আনইনস্টল

ternux uninstall                    # প্রস্তাবিত — ইন্টারঅ্যাক্টিভ অপসারণ
# বা
curl -fsSL https://soobujmiah.github.io/ternux/uninstall.sh | bash
# বা
bash install.sh --uninstall

all মানে command-এ দেখানো চার scoped target: session বন্ধ, ~/x.sh ও ternux alias block অপসারণ, state/log অপসারণ এবং Debian container delete। এটি Termux package বা installed ternux CLI/library uninstall করে না, shared-storage access revocation বা repository/mirror choice restore করে না, এবং Termux default.pa-এর loopback PulseAudio line ফিরিয়ে দেয় না—এগুলো আগে থেকেই থাকতে পারে বলে ইচ্ছাকৃতভাবে রেখে দেওয়া হয়। Termux storage-এর বাইরের Android file delete হয় না। Termux app data clear করা আলাদা nuclear option; তাতেই অবশিষ্ট Termux installation-ও মুছে যায়।

সমস্যা?

ডেস্কটপ চালু হচ্ছে না? রেন্ডারার llvmpipe? শব্দ নেই? দেখুন সমস্যা সমাধান — প্রতিটি লক্ষণের সাথে কারণ ও সমাধান আছে।

ternux — Copyright (c) 2026 Sobuj Miah (@soobujmiah) · Apache-2.0