📘 T4n OS Documentation

Apa itu T4n OS Docs?

T4n OS Docs adalah pusat dokumentasi resmi untuk sistem operasi T4n OS. Dokumentasi ini dirancang untuk membantu pengguna memahami, menggunakan, dan mengembangkan T4n OS dengan cara yang sederhana, terstruktur, dan profesional.

Dokumentasi ini mencakup

• Panduan Instalasi & Penggunaan
• Troubleshooting
• Hal-hal yang Berkaitan dengan T4n OS

Tujuan

Menjadikan T4n OS mudah dipahami oleh siapa pun — baik pemula Linux maupun pengguna tingkat lanjut.

⚠️ Catatan: Dokumentasi ini masih dalam tahap pengembangan dan belum sepenuhnya sempurna. Mohon dimaklumi karena saat ini dikerjakan secara solo. Kontribusi dan masukan sangat diterima!

Apa Itu T4n OS?

T4n OS adalah sistem operasi berbasis Void Linux yang dikembangkan dalam proyek T4n Labs. Proyek ini pertama kali diinisiasi oleh Gh0sT4n pada 17 Agustus 2025 — seorang pelajar asal Atjeh (Darussa'adah Cot Tarom Baroh, SMKN 5 Takengon).

Dibangun di atas fondasi Void Linux, T4n OS mengusung filosofi:

"Keep Things Simple"

Sistem ini dirancang untuk memberikan performa tinggi, struktur yang bersih, dan kontrol penuh kepada pengguna — tanpa komponen yang tidak diperlukan.

Asal Nama "T4n"

Nama "T4n" terinspirasi dari sosok Tan Malaka, seorang pemikir Indonesia yang dikenal dengan gagasan kemerdekaan berpikir dan kemandirian.

Penggunaan angka "4" sebagai pengganti huruf "a" menjadi simbol modernisasi sekaligus identitas digital T4n OS.

Karakteristik

Keunggulan

• Ringan dan cepat
• Tanpa bloatware
• Struktur sistem bersih
• Modular dan terkontrol

Sejarah

Dari Ide Sederhana Menuju Fondasi Ekosistem

Di dunia Linux yang penuh pilihan, lahirnya sebuah distribusi baru bukan hanya soal teknis. Ia adalah manifestasi dari keresahan, hasrat, dan keberanian untuk mandiri. T4n OS bukan sekadar perangkat lunak — ia adalah perjalanan membangun ekosistem T4n Labs.

Inisiasi & Reformasi (17 Agustus 2025)

Proyek T4n OS diinisiasi oleh Gh0sT4n pada 17 Agustus 2025. Dipilihnya tanggal ini bukan tanpa alasan — ia adalah simbol kemerdekaan berpikir. Di tengah gejolak reformasi sosial yang melanda Indonesia saat itu, T4n OS lahir sebagai bentuk "Reformasi Digital".

Terinspirasi dari pemikiran Tan Malaka tentang kemandirian, T4n OS membawa misi untuk melepaskan pengguna dari kompleksitas yang tidak perlu dan ketergantungan pada sistem yang tertutup.

Ditempa oleh Prahara

Perjalanan menuju rilis perdana tidaklah mudah. T4n OS dikembangkan di tengah tantangan alam yang ekstrem di Aceh.

Oktober – November 2025:

• Intensitas Hujan Tinggi — menyebabkan banjir dan longsor di Sumatera
• Krisis Pasokan — hambatan distribusi pangan antara Aceh Tengah dan Bireuen
• Krisis Energi — pemadaman listrik total selama lebih dari satu bulan

Guncangan Alam:

• Rentetan gempa bumi hingga 7 kali dalam semalam di Takengon
• Status siaga Gunung Burni Telong

Namun, keterbatasan inilah yang membentuk filosofi T4n OS menjadi sistem yang tangguh, efisien, dan lincah.

Mengapa Void Linux?

Alih-alih membangun dari nol yang memakan waktu, T4n OS memilih berdiri di atas fondasi yang jujur: Void Linux. Pilihan ini didasari oleh prinsip Musannef (penyusunan yang sistematis) dan logika Manteq:

1. Kontrol Penuh — Penggunaan runit sebagai init system yang simpel dan cepat
2. Performa Maksimal — Tanpa beban bloatware yang memperlambat mesin
3. Kesederhanaan Arsitektur — Sejalan dengan prinsip "Keep Things Simple"
4. Menentang Arus Utama — T4n OS hadir untuk membuktikan bahwa distribusi Linux yang hebat tidak harus mengikuti standar mainstream

Arah Pengembangan

• Let-X (VUR-Helper) — Tools untuk mempermudah manajemen paket di T4n OS maupun Void Linux, menggunakan template dari VUR (T4n-Labs) atau Void Linux
• VUR (Void User Repository) — Membangun ekosistem paket mandiri dari dan untuk komunitas
• Dokumentasi Terstruktur — Penjelasan teknis yang disederhanakan agar mudah dipahami oleh siapa saja

T4n OS bukan proyek instan. Ia adalah manifesto keberanian untuk membangun teknologi yang merdeka — lahir dari guncangan gempa dan kegelapan, menuju cahaya kemandirian.

Instalasi

Bagian ini berisi informasi umum tentang proses instalasi T4n OS yang berbasis pada Void Linux. Untuk panduan konfigurasi tingkat lanjut, silakan lihat bagian Instalasi Lanjutan.

Persyaratan Sistem

T4n OS dirancang ringan dan efisien sehingga dapat berjalan pada perangkat dengan spesifikasi rendah. Untuk pengalaman yang lebih stabil dan nyaman, berikut spesifikasi minimum yang direkomendasikan:

⚠️ Catatan: Edisi dengan desktop environment (seperti Xfce) membutuhkan sumber daya yang lebih besar. Kebutuhan sistem juga dapat meningkat tergantung aplikasi yang digunakan.

Dukungan Arsitektur

Saat ini T4n OS tersedia untuk arsitektur x86_64.

Koneksi internet saat instalasi disarankan, tetapi tidak wajib — ISO T4n OS sudah berisi paket dasar sehingga instalasi dapat dilakukan secara offline.

Unduh File ISO

Memverifikasi File ISO

1. Pilih Varian T4n OS

2. Unduh File yang Diperlukan

Pastikan semua file berikut sudah terunduh sebelum melanjutkan:

• *.iso — Image instalasi T4n OS
• SHA256SUMS — Daftar checksum file
• SHA256SUMS.sig — Tanda tangan digital
• t4n-public.key — Public key developer

3. Verifikasi Keamanan

🔐 Langkah ini penting untuk memastikan file ISO aman dan asli dari developer.

Import Public Key

gpg --import t4n-public.key

Verifikasi Signature

gpg --verify SHA256SUMS.sig

Jika berhasil, akan muncul output berikut:

Good signature from "T4nLabs ..."

Cek Integritas File ISO

sha256sum -c SHA256SUMS

Jika file valid:

T4nOS-x86_64-XXXX.iso: OK

Panduan Beginner

Installer Langsung (Live Installer)

T4n OS menyediakan Live ISO yang berisi utilitas dasar, program installer, dan paket sistem untuk menginstal sistem baru.

Saat ini tersedia untuk arsitektur:

• x86_64 (glibc)

Jenis Gambar Installer

T4n OS merilis dua jenis gambar installer:

Gambar Dasar (Base Image)

Gambar Base menyediakan paket minimal untuk membangun sistem T4n OS yang fungsional — cukup untuk mengonfigurasi mesin baru dan memperbarui sistem. Cocok untuk pengguna advanced yang ingin membangun sistem sepenuhnya dari awal.

Gambar Xfce (Desktop Image)

Gambar Xfce menyediakan lingkungan desktop lengkap yang siap pakai, berbasis Xfce Desktop Environment.

Perangkat Lunak yang Disertakan

⚠️ Penting Saat Instalasi Xfce

Jika menggunakan gambar Xfce, wajib memilih sumber instalasi Local.

Jika memilih Network, installer hanya akan mengunduh sistem dasar terbaru tanpa menyertakan paket tambahan dari Live ISO.

Dukungan Aksesibilitas

Semua gambar installer mendukung aksesibilitas konsol berikut:

• espeakup — pembaca layar konsol
• brltty — driver braille konsol

Jika sumber instalasi Local dipilih, kedua paket ini akan ikut terinstal dan aktif pada sistem baru.

Bootloader

Tombol Pintas Bootloader

Catatan: Pada SYSLINUX, tekan Enter setelah memilih shortcut. Jika beberapa kartu suara terdeteksi, akan muncul menu pemilihan audio — tekan Enter saat bunyi terdengar untuk memilih perangkat tersebut.

Dukungan Aksesibilitas Grafis (Xfce)

Gambar Xfce juga mendukung pembaca layar grafis Orca. Untuk mengaktifkannya:

Win + R  →  orca -r

Jika sumber instalasi Local dipilih, Orca juga akan tersedia pada sistem yang terinstal.

Parameter Kernel

Installer mendukung berbagai parameter kernel untuk mengubah perilaku sistem live. Daftar lengkapnya tersedia di:

📄 Kernel CLI Parameter

Persiapan Media

Setelah mengunduh file ISO T4n OS, langkah berikutnya adalah membuat media instalasi yang dapat digunakan untuk boot — USB, SD Card, atau DVD.

1. Membuat USB / SD Card Bootable (Linux)

Langkah 1: Identifikasi Perangkat

Sebelum menulis ISO, pastikan kamu tahu device mana yang akan digunakan. Colokkan USB atau SD Card, lalu jalankan:

fdisk -l

Contoh output:

Disk /dev/sda: 7.5 GiB, 8036286464 bytes, 15695872 sectors
Disk model: Your USB Device's Model

Pola umum nama device:

• USB → /dev/sdX
• SD Card → /dev/mmcblkX

Langkah 2: Unmount Perangkat

Pastikan perangkat tidak sedang digunakan:

umount /dev/sdX

Jika muncul pesan not mounted, artinya aman untuk dilanjutkan.

Langkah 3: Tulis ISO ke USB

Software yang Bisa Digunakan

Via dd (Terminal)

dd bs=4M if=/path/to/T4nOS-x86_64.iso of=/dev/sdX status=progress

⚠️ PERINGATAN: Semua data di USB akan terhapus permanen. Pastikan device yang dipilih sudah benar sebelum menjalankan perintah ini.

Output saat proses selesai akan terlihat seperti ini:

377487360 bytes copied, 20 s, 18 MB/s

Langkah 4: Sinkronisasi Data

sync

Jalankan perintah ini untuk memastikan semua data benar-benar tersimpan sebelum USB dicabut.

2. Burning ISO ke CD/DVD

Jika ingin menggunakan CD/DVD, berikut aplikasi yang tersedia:

Cara umum:

1. Buka aplikasi
2. Pilih "Burn ISO Image"
3. Pilih file ISO T4n OS
4. Klik Burn

⚠️ Catatan: CD/DVD lebih lambat dibanding USB dan kurang responsif saat live boot.

Tips Tambahan

• Gunakan USB minimal 8 GB
• Pastikan file ISO tidak corrupt — verifikasi SHA256 sebelum menulis
• Gunakan port USB langsung, hindari USB hub jika ada masalah
• Jika gagal boot, periksa pengaturan Boot Priority di BIOS/UEFI

Partisi

Pemartisian adalah proses membagi penyimpanan (HDD/SSD) menjadi beberapa bagian sebelum instalasi sistem operasi.

Pada sistem Linux modern, partisi yang umum digunakan:

1. Memahami Tipe Partisi

Saat menggunakan tools seperti cfdisk, kamu akan melihat dua skema partisi:

• Label: dos → skema MBR
• Label: gpt → skema GPT

Jika disk masih berisi partisi lama, kamu bisa menghapusnya dengan:

wipefs -a /dev/sdX

Atau langsung reset saat membuka cfdisk:

cfdisk -z /dev/sdX

2. Sistem BIOS (Legacy)

Untuk sistem BIOS lama, disarankan menggunakan skema MBR (dos) dengan batasan maksimal 4 partisi utama.

Jika ingin menggunakan GPT di BIOS

⚠️ Kamu wajib membuat partisi khusus berikut agar GRUB dapat berjalan dengan benar:

3. Sistem UEFI (Modern)

Untuk sistem UEFI, wajib menggunakan GPT.

EFI System Partition (ESP)

Partisi ini digunakan oleh firmware UEFI untuk proses booting.

4. Partisi Swap

Swap adalah memori cadangan yang digunakan saat RAM penuh.

Catatan: Swap tidak wajib, tetapi diperlukan jika ingin menggunakan fitur hibernasi.

5. Partisi Root (/)

Partisi utama tempat T4n OS diinstal.

• Minimal: 20 GB
• Ideal: 30 GB ke atas
• Format: ext4

6. Partisi /home (Direkomendasikan)

Digunakan untuk menyimpan file pribadi dan konfigurasi aplikasi pengguna. Memisahkan /home dari root memudahkan reinstall OS tanpa kehilangan data pengguna.

7. Partisi /boot (Opsional)

Biasanya tidak diperlukan di sistem modern. Jika digunakan:

• Ukuran: ±200 MB
• Isi: Kernel & bootloader

⚠️ Perhatian: Kernel Linux akan terus bertambah ukurannya setiap update. T4n OS (seperti Void Linux) tidak menghapus kernel lama secara otomatis, jadi pastikan ukuran partisi /boot cukup.

8. Contoh Skema Partisi

UEFI (Direkomendasikan)

BIOS (MBR)

⚠️ Tips Penting

• Selalu backup data sebelum melakukan partisi
• Pastikan memilih disk yang benar (/dev/sdX)
• Gunakan cfdisk untuk pemula — antarmuka lebih mudah dipahami
• Gunakan GPT jika sistem mendukung UEFI (lebih modern dan fleksibel)

Panduan Instalasi

Sebelum melanjutkan, pastikan kamu telah:

• Mengunduh ISO T4n OS
• Membuat media bootable (USB/DVD)

⚠️ Persiapan Penting

Sebelum mulai, pastikan kamu mengetahui jenis firmware sistem kamu:

• BIOS (Legacy)
• UEFI (Modern)

Jenis firmware akan memengaruhi skema partisi yang digunakan. Lihat dokumentasi partisi untuk referensi.

Fitur yang tidak didukung installer: LVM, LUKS (enkripsi disk), ZFS.

Booting

1. Nyalakan komputer.
2. Masuk ke boot menu — biasanya F2, F12, ESC, atau DEL.
3. Pilih perangkat USB / DVD T4n OS.

Tips: Tersedia opsi load ke RAM. Proses awal lebih lambat, tetapi instalasi berjalan lebih cepat setelahnya.

Masuk ke Live System

Login menggunakan kredensial berikut:

Installer

T4n OS menyediakan dua pilihan installer:

1. CLI Installer

Installer berbasis menu (TUI).

t4n-installer

2. GUI Installer (Alpha)

t4n-installer-gui

Dibangun dengan Python. Langkah konfigurasi sama seperti CLI installer.

Konfigurasi Installer

Keyboard

Pilih layout keyboard yang sesuai. Gunakan us untuk keyboard standar.

Jaringan

T4n OS menggunakan NetworkManager sebagai pengelola jaringan default.

Ethernet (Kabel)

Koneksi biasanya terdeteksi otomatis melalui DHCP.

WiFi

Jalankan step ini(Jika T4n OS Base) :

1. Shell

nmtui

2. NTUI Option > Activate a Connection
3. Pilih Wifi dan Masukkan Password
4. Pilih Back, lalu Enter
5. Pilih Quit, lalu Enter

Jika koneksi gagal: Keluar dari installer, lalu konfigurasi jaringan secara manual menggunakan wpa_supplicant dan dhcpcd.

Isi informasi berikut: | Field | Keterangan | |-------------|-----------------------------| | SSID | Nama jaringan WiFi | | Enkripsi| wpa atau wep | | Password| Password jaringan |

Dokumentasi WPA_Supplicant & DHCPCD

Source (Sumber Instalasi)

⚠️ Jika menggunakan ISO XFCE, wajib pilih Local.

Hostname

Masukkan nama komputer. Contoh:

T4nLabs

Locale

Pilih bahasa dan pengaturan regional. Contoh:

• en_US.UTF-8
• id_ID.UTF-8

Timezone

Pilih zona waktu. Contoh:

• Asia/Jakarta

Password Root

Masukkan password untuk akun root.

Karakter tidak akan terlihat saat mengetik — ini normal.

User

Buat akun pengguna baru dengan mengisi:

• Username (default: void)
• Nama lengkap
• Password

User yang dibuat otomatis masuk ke grup wheel sehingga dapat menggunakan sudo.

Partisi

Pilih tool partisi yang tersedia sesuai installer yang digunakan:

Langkah:

1. Pilih disk target (contoh: /dev/sda).
2. Buat partisi yang diperlukan:

3. Pilih Write, lalu Quit (atau Apply untuk GParted).

Skema partisi berdasarkan firmware:

Filesystem

Untuk setiap partisi, tentukan filesystem dan mount point:

Bootloader

Pilih lokasi instalasi bootloader:

• Pilih disk (contoh: /dev/sda), atau
• Pilih none untuk konfigurasi manual.

Bootloader yang digunakan: GRUB

Review

Periksa semua konfigurasi sebelum melanjutkan. Pastikan:

• Disk yang dipilih sudah benar.
• Mount point sudah sesuai.
• Bootloader sudah dikonfigurasi.

Proses Instalasi

Pilih Install untuk memulai. Installer akan secara otomatis:

1. Memformat partisi
2. Menginstal sistem dasar
3. Membuat initramfs
4. Menginstal GRUB

⏳ Tunggu hingga proses selesai.

Selesai & Reboot

Setelah instalasi sukses, jalankan:

loginctl reboot

Lalu cabut media USB/DVD dari perangkat.

Pasca Instalasi

Setelah masuk ke sistem, segera lakukan pembaruan:

sudo xbps-install -Su -y

Lihat Dokumentasi XBPS untuk penggunaan lebih lanjut.

Panduan Instalasi Advanced

Bagian ini berisi panduan untuk kasus penggunaan yang lebih spesifik atau kompleks.

Daftar Isi

Instalasi via Chroot (x86_64 / i686 / aarch64)

Catatan: T4n OS belum menyediakan ROOTFS sendiri. Gunakan ROOTFS dari Void Linux sebagai gantinya.

Panduan ini menjelaskan proses instalasi T4n OS secara manual melalui chroot. Diasumsikan kamu sudah familiar dengan Linux, namun belum tentu dengan metode instalasi via chroot.

Panduan ini mencakup pengaturan tipikal — satu partisi pada satu disk SATA/IDE/USB — namun setiap langkah dapat dimodifikasi sesuai kebutuhan (termasuk enkripsi disk penuh).

Metode Instalasi

T4n OS menyediakan dua metode instalasi:

Metode ROOTFS lebih fleksibel — bisa digunakan dari distro Linux mana pun.

1. Persiapan Sistem File

Partisi Disk

Tool yang tersedia untuk partisi:

cfdisk   # Antarmuka TUI, paling mudah
fdisk    # CLI klasik

Tool tambahan seperti gdisk (dari paket gptfdisk) atau parted juga dapat digunakan jika dibutuhkan.

Format Partisi

Gunakan tool sesuai filesystem yang dipilih:

mkfs.ext4  /dev/sdXN   # ext4  — disarankan untuk /
mkfs.xfs   /dev/sdXN   # XFS
mkfs.btrfs /dev/sdXN   # Btrfs
mkfs.vfat  /dev/sdXN   # FAT32 — hanya untuk partisi EFI

Skema Partisi yang Disarankan

UEFI (GPT)

# Contoh format:
mkfs.vfat /dev/sda1
mkfs.ext4 /dev/sda2

BIOS (MBR)

Tidak memerlukan partisi /boot terpisah kecuali menggunakan enkripsi atau LVM.

2. Mount Sistem File

# Mount root
mount /dev/sda2 /mnt

# Khusus UEFI: mount partisi EFI
mkdir -p /mnt/boot/efi
mount /dev/sda1 /mnt/boot/efi

Aktifkan swap jika ada:

mkswap  /dev/sdXN
swapon  /dev/sdXN

3. Instalasi Dasar

Ikuti salah satu metode berikut.

Untuk arsitektur aarch64, instal paket kernel tambahan linux bersama base-system.

Metode XBPS

Set variabel repository dan arsitektur:

REPO=https://repo-default.voidlinux.org/current
ARCH=x86_64   # Pilihan: x86_64 | x86_64-musl | i686 | aarch64 | aarch64-musl

Salin kunci RSA:

mkdir -p /mnt/var/db/xbps/keys
cp /var/db/xbps/keys/* /mnt/var/db/xbps/keys/

Bootstrap sistem dasar:

XBPS_ARCH=$ARCH xbps-install -S -r /mnt -R "$REPO" base-system

Metode ROOTFS

Unduh tarball ROOTFS sesuai arsitektur, lalu ekstrak:

tar xvf void-<...>-ROOTFS.tar.xz -C /mnt

Update dan instal base-system:

xbps-install -r /mnt -Su xbps
xbps-install -r /mnt -u
xbps-install -r /mnt base-system
xbps-remove  -r /mnt -R base-container-full

4. Masuk ke Chroot

xchroot /mnt /bin/bash

5. Konfigurasi Sistem

Hostname

echo "NamaKomputer" > /etc/hostname

Locale

Edit /etc/default/libc-locales, hapus komentar pada locale yang diinginkan. Contoh:

en_US.UTF-8 UTF-8
id_ID.UTF-8 UTF-8

Generate locale (khusus glibc):

xbps-reconfigure -f glibc-locales

Timezone & rc.conf

Telusuri opsi di /etc/rc.conf untuk timezone dan pengaturan sistem lainnya.

Password Root

passwd

Minimal harus ada password root, atau akun user dengan hak sudo.

Buat User Baru (Opsional)

useradd -m -G wheel,audio,video,plugdev namauser
passwd namauser

6. Aktifkan Layanan

Aktifkan layanan yang diperlukan agar tersedia saat sistem pertama kali booting. Contoh:

ln -s /etc/sv/dhcpcd /etc/runit/runsvdir/default/
ln -s /etc/sv/sshd   /etc/runit/runsvdir/default/

7. Instalasi GRUB

BIOS

xbps-install -S grub
grub-install /dev/sda   # Arahkan ke disk, bukan ke partisi

UEFI

xbps-install -S grub-x86_64-efi
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="T4nOS"

Sesuaikan --target dengan arsitektur:

Arsitektur	Target
x86_64	x86_64-efi
i686	i386-efi
aarch64	arm64-efi

Troubleshooting GRUB (UEFI)

Jika variabel EFI tidak tersedia, mount terlebih dahulu efivarfs:

mount -t efivarfs none /sys/firmware/efi/efivars

Jika masih gagal, tambahkan flag --no-nvram:

grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="T4nOS" --no-nvram

Instalasi ke Media Removable / Firmware UEFI Non-Standar

Tambahkan flag --removable:

grub-install --target=x86_64-efi --efi-directory=/boot/efi --removable

Atau salin file GRUB ke lokasi fallback secara manual:

mkdir -p /boot/efi/EFI/boot
cp /boot/efi/EFI/T4nOS/grubx64.efi /boot/efi/EFI/boot/bootx64.efi

Nama file berbeda per arsitektur:

Arsitektur	File GRUB	File Fallback
x86_64	grubx64.efi	bootx64.efi
i686	grubia32.efi	bootia32.efi
aarch64	grubaa64.efi	bootaa64.efi

8. Finalisasi

Pastikan semua paket terkonfigurasi dengan benar — ini juga akan men-generate initramfs dan konfigurasi GRUB:

xbps-reconfigure -fa

Keluar dari chroot dan reboot:

exit
umount -R /mnt
shutdown -r now

Pasca Instalasi

Setelah berhasil booting ke T4n OS, segera lakukan pembaruan sistem:

sudo xbps-install -Su

Full Disk Encryption (FDE)

Panduan ini menjelaskan cara menginstal T4n OS dengan enkripsi disk penuh menggunakan LUKS + LVM.

⚠️ Peringatan: Nama block device (/dev/sda, /dev/sda1, dll.) di sistem kamu mungkin berbeda. Jangan salin perintah secara langsung — sesuaikan terlebih dahulu dengan output di sistem kamu.

Skema Partisi

BIOS (MBR)

UEFI (GPT)

Buat partisi menggunakan cfdisk atau fdisk, lalu tandai partisi utama sebagai bootable (khusus BIOS/MBR).

Konfigurasi Volume Terenkripsi

Catatan LUKS: Panduan ini menggunakan LUKS1 karena GRUB sebelum versi 2.06 hanya mendukung LUKS1. LUKS2 hanya didukung sebagian — hanya KDF PBKDF2 yang diimplementasikan, sedangkan default LUKS2 menggunakan Argon2i yang tidak dapat didekripsi oleh GRUB.

1. Format Partisi dengan LUKS1

# BIOS: gunakan /dev/sda1
# UEFI: gunakan /dev/sda2
cryptsetup luksFormat --type luks1 /dev/sda1

2. Buka Volume LUKS

cryptsetup luksOpen /dev/sda1 voidvm

Ganti voidvm dengan nama yang diinginkan.

3. Buat Volume Group LVM

vgcreate voidvm /dev/mapper/voidvm

4. Buat Logical Volume

lvcreate --name root -L 10G      voidvm
lvcreate --name swap -L 2G       voidvm
lvcreate --name home -l 100%FREE voidvm

Sesuaikan ukuran sesuai kebutuhan.

5. Format Filesystem

mkfs.xfs -L root /dev/voidvm/root
mkfs.xfs -L home /dev/voidvm/home
mkswap /dev/voidvm/swap
swapon /dev/voidvm/swap

Filesystem lain yang didukung GRUB (ext4, btrfs, dll.) juga dapat digunakan.

Instalasi Sistem

Mount Partisi

mount /dev/voidvm/root /mnt
mkdir -p /mnt/home
mount /dev/voidvm/home /mnt/home

Khusus UEFI, format dan mount partisi EFI:

mkfs.vfat /dev/sda1
mkdir -p  /mnt/boot/efi
mount /dev/sda1 /mnt/boot/efi

Salin Kunci RSA

mkdir -p /mnt/var/db/xbps/keys
cp /var/db/xbps/keys/* /mnt/var/db/xbps/keys/

Instal Sistem Dasar

BIOS:

xbps-install -Sy -R https://repo-default.voidlinux.org/current -r /mnt \
  base-system lvm2 cryptsetup grub

UEFI:

xbps-install -Sy -R https://repo-default.voidlinux.org/current -r /mnt \
  base-system lvm2 cryptsetup grub-x86_64-efi

Konfigurasi

Generate fstab

xgenfstab /mnt > /mnt/etc/fstab

Masuk ke Chroot

xchroot /mnt
chown root:root /
chmod 755 /
passwd root
echo "voidvm" > /etc/hostname

Locale (khusus glibc)

echo "LANG=id_ID.UTF-8" > /etc/locale.conf
echo "id_ID.UTF-8 UTF-8" >> /etc/default/libc-locales
xbps-reconfigure -f glibc-locales

Konfigurasi GRUB

Aktifkan Dukungan Cryptodisk

Tambahkan baris berikut ke /etc/default/grub:

GRUB_ENABLE_CRYPTODISK=y

Tambahkan Parameter Kernel

Cari UUID partisi terenkripsi:

blkid -o value -s UUID /dev/sda1

Edit GRUB_CMDLINE_LINUX_DEFAULT di /etc/default/grub, tambahkan:

rd.lvm.vg=voidvm rd.luks.uuid=<UUID>

Ganti <UUID> dengan nilai dari output blkid di atas. Untuk UEFI, UUID yang digunakan adalah milik /dev/sda2.

Konfigurasi Keyfile (Agar Tidak Input Password Dua Kali)

1. Generate Key Acak

dd bs=1 count=64 if=/dev/urandom of=/boot/volume.key

2. Tambahkan Key ke Volume LUKS

cryptsetup luksAddKey /dev/sda1 /boot/volume.key

3. Amankan Permissions

chmod 000 /boot/volume.key
chmod -R g-rwx,o-rwx /boot

4. Tambahkan ke /etc/crypttab

voidvm   /dev/sda1   /boot/volume.key   luks

Untuk UEFI, ganti /dev/sda1 dengan /dev/sda2.

5. Sertakan Keyfile dalam initramfs

Buat file /etc/dracut.conf.d/10-crypt.conf:

install_items+=" /boot/volume.key /etc/crypttab "

Finalisasi

Instal GRUB

# BIOS
grub-install /dev/sda

# UEFI
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="T4nOS"

Generate initramfs

xbps-reconfigure -fa

Reboot

exit
umount -R /mnt
reboot

Ringkasan Langkah

Instalasi T4n OS dengan ZFS Root

Karena installer T4n OS tidak mendukung ZFS secara langsung, instalasi harus dilakukan via chroot. Selain beberapa hal terkait bootloader dan initramfs, prosesnya tidak jauh berbeda dari instalasi chroot biasa.

Pilihan Bootloader

ZFSBootMenu (Disarankan)

ZFSBootMenu adalah bootloader yang dirancang khusus untuk booting langsung dari ZFS pool. Fitur unggulan:

• Mendukung enkripsi native ZFS
• Menyediakan recovery environment (clone snapshot, manipulasi pre-boot)
• Dapat booting dari pool manapun yang bisa di-import oleh driver ZFS modern
• Void Linux adalah distribusi first-class di ZFSBootMenu

Panduan instalasi tersedia di dokumentasi ZFSBootMenu:

Bootloader Tradisional (GRUB, dll.)

Jika tidak ingin menggunakan ZFSBootMenu, gunakan bootloader konvensional dengan catatan: buat partisi /boot terpisah menggunakan ext4 atau xfs untuk menghindari kompleksitas yang tidak perlu.

Media Instalasi

Installer T4n OS membutuhkan live image yang sudah menyertakan driver ZFS. Ada dua pilihan:

Partisi Disk

Setelah booting dari live image ZFS, buat partisi disk:

Catatan swap:

• Swap bisa diletakkan di ZFS zvol, namun berisiko deadlock kernel saat memory pressure tinggi.
• Jika ingin menggunakan hibernasi, wajib gunakan partisi swap terpisah — kernel tidak dapat resume dari zvol.

Format partisi non-ZFS:

mkfs.vfat /dev/sda1   # EFI
mkfs.ext4 /dev/sda2   # /boot
mkswap /dev/sda3   # swap (opsional)

Membuat ZFS Pool

Buat pool pada partisi yang sudah disiapkan. Gunakan path dari /dev/disk/by-id/ agar lebih aman:

zpool create -f -o ashift=12 \
    -O compression=lz4      \
    -O acltype=posixacl     \
    -O xattr=sa             \
    -O relatime=on          \
    -o autotrim=on          \
    -m none zroot /dev/disk/by-id/<id-partisi>

Ganti <id-partisi> dengan ID disk yang sesuai (cek dengan ls /dev/disk/by-id/).

⚠️ Selalu gunakan /dev/disk/by-id/ atau /dev/disk/by-partuuid/ — hindari /dev/sda3 karena penamaan dapat berubah dan menyebabkan gagal import.

Export lalu re-import pool dengan path alternatif sementara:

zpool export zroot
zpool import -N -R /mnt zroot

Membuat Filesystem ZFS

Buat hierarki filesystem. Konvensi umum menempatkan root OS di bawah ROOT:

# Parent untuk boot environments
zfs create -o mountpoint=none zroot/ROOT

# Root filesystem T4n OS
zfs create -o mountpoint=/ -o canmount=noauto zroot/ROOT/void

# Home directory (opsional tapi disarankan)
zfs create -o mountpoint=/home zroot/home

canmount=noauto pada filesystem root berguna agar ZFS tidak otomatis me-mount satu boot environment di atas yang lain jika terdapat beberapa sistem yang terpasang.

Mount Hierarki ZFS

# Mount root secara manual terlebih dahulu
zfs mount zroot/ROOT/void

# Mount semua filesystem lainnya secara otomatis
zfs mount -a

Simpan konfigurasi pool ke cache untuk mempercepat import saat boot:

mkdir -p /mnt/etc/zfs
zpool set cachefile=/mnt/etc/zfs/zpool.cache zroot

Mount partisi non-ZFS:

# /boot
mkdir -p  /mnt/boot
mount /dev/sda2 /mnt/boot

# EFI (khusus UEFI)
mkdir -p  /mnt/boot/efi
mount /dev/sda1 /mnt/boot/efi

Instalasi Sistem

Lanjutkan dengan instalasi chroot standar (lihat Instalasi via Chroot) hingga bagian sebelum Finalisasi.

Sebelum menjalankan langkah finalisasi, instal paket ZFS dan konfigurasi dracut:

mkdir -p /etc/dracut.conf.d
cat > /etc/dracut.conf.d/zol.conf <<EOF
nofsck="yes"
add_dracutmodules+=" zfs "
omit_dracutmodules+=" btrfs resume "
EOF

xbps-install -S zfs

Kemudian lanjutkan langkah Finalisasi dari panduan chroot (generate initramfs, install bootloader, reboot).

Ringkasan Langkah

Perangkat ARM (Coming Soon)

T4n OS menyediakan paket dan image untuk beberapa perangkat ARM. Instalasi dapat dilakukan dengan beberapa metode:

Dokumentasi spesifik per platform tersedia untuk:

• Apple Silicon
• Lenovo ThinkPad X13s
• Pinebook Pro
• Raspberry Pi

Karena sebagian besar perintah dijalankan pada storage eksternal, selalu jalankan sync sebelum mencabut perangkat.

Instalasi

Pre-built Image

Image pre-built disiapkan untuk storage 1 GB. Setelah mengunduh dan memverifikasi image:

# Ekstrak image
unxz -k <image>.img.xz

# Flash ke SD card (sesuaikan /dev/mmcblk0 dengan perangkat kamu)
sudo dd if=<image>.img of=/dev/mmcblk0 bs=4M status=progress

Saat pertama kali boot, partisi root akan otomatis diperluas untuk mengisi ruang yang tersedia menggunakan growpart.

Untuk menonaktifkan auto-expand, komentari baris berikut di /etc/default/growpart:

# ENABLE_ROOT_GROWPART=yes

Untuk memperluas partisi secara manual setelah flashing:

# Perluas partisi dengan cfdisk atau fdisk
cfdisk /dev/mmcblk0

# Resize filesystem ke ukuran partisi baru
resize2fs /dev/mmcblk0p2

Layout Partisi Kustom

Untuk kustomisasi layout partisi, gunakan metode Tarball atau Chroot.

Skema Partisi ARM (MS-DOS Partition Table)

Jika menggunakan SD card, buat ext4 dengan opsi ^has_journal untuk menonaktifkan journaling dan memperpanjang umur kartu (dengan risiko kehilangan data lebih tinggi):

mkfs.ext4 -O ^has_journal /dev/mmcblk0p2

Mount partisi:

mount /dev/mmcblk0p2 /mnt
mkdir /mnt/boot
mount /dev/mmcblk0p1 /mnt/boot

Tarball Installation

Unduh dan verifikasi tarball PLATFORMFS atau ROOTFS, lalu ekstrak ke filesystem yang sudah di-mount:

tar xvfp <image>.tar.xz -C /mnt

Chroot Installation

Ikuti panduan Instalasi via Chroot dengan arsitektur dan paket base yang sesuai.

Instalasi dari x86_64 (Cross-Architecture)

Jika melakukan instalasi dari komputer x86_64 untuk perangkat ARM:

# Instal emulator QEMU yang sesuai
sudo xbps-install -S binfmt-support qemu-user-aarch64   # untuk aarch64
# atau
sudo xbps-install -S binfmt-support qemu-user-arm       # untuk ARM 32-bit

# Aktifkan layanan binfmt
ln -s /etc/sv/binfmt-support /var/service/

# Jika binfmt-support diinstal setelah QEMU, reconfigure:
sudo xbps-reconfigure -f qemu-user-aarch64

Konfigurasi

Login Awal

Untuk pre-built image dan tarball installation, gunakan:

fstab

Tambahkan partisi /boot ke /etc/fstab agar update kernel berjalan dengan benar:

/dev/mmcblk0p1  /boot  vfat  defaults  0  0

Tanpa entri ini, update kernel dapat menyebabkan modul kernel tidak ditemukan — termasuk modul WiFi.

Waktu Sistem (RTC)

Sebagian besar perangkat ARM tidak memiliki Real Time Clock (RTC) berbaterai, sehingga waktu tidak tersimpan saat dimatikan. Gejala umum: error HTTPS saat browsing atau menggunakan package manager.

Set waktu secara manual:

date -s "2026-01-01 12:00:00"

Solusi permanen — instal NTP client:

sudo xbps-install -S chrony
ln -s /etc/sv/chronyd /var/service/

Solusi tambahan — fake-hwclock:

fake-hwclock menyimpan waktu terakhir secara berkala dan memuatnya saat boot, sehingga perkiraan waktu awal lebih akurat meski tanpa koneksi jaringan:

sudo xbps-install -S fake-hwclock
ln -s /etc/sv/fake-hwclock /var/service/

Troubleshooting: chrony User Hilang

Pada image sebelum 2026-03-16, instalasi chrony mungkin tidak lengkap dan user chrony tidak terbuat. Cek dengan:

getent group chrony

Jika output kosong, perbaiki dengan:

sudo xbps-reconfigure -f chrony

Apple Silicon (Coming Soon)

Dukungan T4n OS untuk Apple Silicon berbasis Asahi Linux. Lihat website dan dokumentasi Asahi Linux untuk informasi lebih lanjut.

Instalasi

1. Siapkan UEFI Environment via Asahi Installer

Jalankan dari macOS (bukan dari live USB):

curl https://alx.sh > alx.sh
sh ./alx.sh

Pilih opsi "UEFI environment only". Saat diminta, biarkan Asahi Installer membuat ruang kosong untuk partisi root T4n OS.

⚠️ Jangan mencoba mengecilkan atau mengubah APFS container secara manual dari live ISO T4n OS. Gunakan fasilitas yang disediakan oleh Asahi Installer.

2. Buat Live USB T4n OS

Unduh ISO T4n OS untuk Apple Silicon lalu buat Live USB.

U-Boot yang terinstal oleh Asahi Installer seharusnya mendeteksi USB secara otomatis. Jika tidak, jalankan perintah berikut di prompt U-Boot:

setenv boot_targets "usb"
setenv bootmeths "efi"
boot

3. Instalasi via Chroot (Metode XBPS)

Ikuti panduan Instalasi via Chroot dengan catatan berikut:

• Jangan ubah struktur disk selain ruang kosong yang disiapkan Asahi Installer.
• EFI System Partition yang digunakan adalah partisi yang dibuat oleh Asahi Installer — mount di /mnt/boot/efi.
• Saat instalasi paket base, instal base-system dan asahi-base:

xbps-install -S base-system asahi-base

• Saat menjalankan grub-install, tambahkan flag --removable:

grub-install --removable --target=arm64-efi --efi-directory=/boot/efi

Bootloader Alternatif (m1n1)

Jika menggunakan bootloader selain GRUB bersama m1n1, pastikan executable EFI bootloader terinstal di:

EFI/BOOT/BOOTAA64.EFI

m1n1 juga dapat dikonfigurasi untuk booting langsung dari kernel dan initramfs tanpa bootloader. Edit /etc/default/m1n1-kernel-hook dan ubah nilai PAYLOAD:

PAYLOAD=kernel

Audio

Instal paket asahi-audio dan aktifkan layanan yang diperlukan:

xbps-install -S asahi-audio
ln -s /etc/sv/speakersafetyd /var/service/

Lalu konfigurasi PipeWire dan WirePlumber — lihat dokumentasi PipeWire.

Firmware

Perbarui firmware menggunakan asahi-fwupdate dari paket asahi-scripts:

xbps-install -S asahi-scripts
asahi-fwupdate

Disarankan menjalankan asahi-fwupdate setiap kali paket asahi-firmware diperbarui.

Lenovo ThinkPad X13s (Coming Soon)

ThinkPad X13s berbasis Snapdragon didukung pada kernel 6.8 ke atas. Untuk status dukungan fitur terkini, lihat wiki jhovold.

Instalasi

1. Persiapan UEFI

Lakukan dari Windows sebelum memulai instalasi:

1. Perbarui firmware UEFI ke versi 1.59 atau lebih baru.
2. Masuk ke pengaturan UEFI firmware, lalu:
   • Nonaktifkan Secure Boot.
   • Aktifkan Linux Boot.

2. Boot Live ISO

Boot menggunakan ISO aarch64 T4n OS. Di menu GRUB, pilih salah satu entri "Void Linux for Thinkpad X13s".

3. Instalasi via Chroot (Metode XBPS)

Ikuti panduan Instalasi via Chroot dengan catatan berikut:

Saat instalasi paket base, instal base-system dan x13s-base:

xbps-install -S base-system x13s-base

Sebelum menjalankan grub-install, tambahkan baris berikut ke /etc/default/grub:

GRUB_CMDLINE_LINUX_DEFAULT="$GRUB_CMDLINE_LINUX_DEFAULT arm64.nopauth clk_ignore_unused pd_ignore_unused"
GRUB_DEFAULT_DTB="qcom/sc8280xp-lenovo-thinkpad-x13s.dtb"

Kemudian jalankan grub-install seperti biasa.

Jika menggunakan bootloader lain selain GRUB, pastikan parameter kernel berikut tetap disertakan:

arm64.nopauth clk_ignore_unused pd_ignore_unused

WWAN (LTE)

Untuk mengaktifkan modem WWAN, instal ModemManager lalu buka kunci modem (FCC unlock):

sudo xbps-install -S ModemManager
sudo mkdir -p /etc/ModemManager/fcc-unlock.d
sudo ln -s /usr/share/ModemManager/fcc-unlock.available.d/105b \
    /etc/ModemManager/fcc-unlock.d/105b:e0c3

Aktifkan layanan ModemManager:

ln -s /etc/sv/ModemManager /var/service/

Pinebook Pro (Coming Soon)

Pinebook Pro adalah laptop berbasis Rockchip RK3399. Lihat dokumentasi Pine64 untuk informasi lebih lanjut.

Instalasi

1. Siapkan Firmware U-Boot

Live ISO T4n OS bersifat generik dan tidak menyertakan U-Boot. Kamu perlu menyediakan firmware sendiri yang terinstal di SPI flash internal, eMMC, atau SD card. Pilihan firmware yang tersedia:

2. Boot Live ISO

Boot menggunakan ISO aarch64 T4n OS. Di menu GRUB, pilih salah satu entri "Void Linux for Pinebook Pro".

3. Instalasi via Chroot (Metode XBPS)

Ikuti panduan Instalasi via Chroot dengan catatan berikut:

Saat instalasi paket base, instal base-system dan pinebookpro-base:

xbps-install -S base-system pinebookpro-base

Sebelum menjalankan grub-install, tambahkan baris berikut ke /etc/default/grub:

GRUB_CMDLINE_LINUX_DEFAULT="$GRUB_CMDLINE_LINUX_DEFAULT console=ttyS2,115200 video=eDP-1:1920x1080x60"
GRUB_DEFAULT_DTB="rockchip/rk3399-pinebook-pro.dtb"

Kemudian jalankan grub-install seperti biasa.

Jika menggunakan bootloader lain selain GRUB, pastikan parameter kernel berikut tetap disertakan:

console=ttyS2,115200 video=eDP-1:1920x1080x60

Raspberry Pi (Coming Soon)

T4n OS menggunakan kernel dari Raspberry Pi Foundation (rpi-kernel) yang mengaktifkan semua fitur khusus RPi yang tidak tersedia di kernel mainline.

Paket penting:

Parameter kernel tersimpan di /boot/cmdline.txt.

Model yang Didukung

RPi 3 dapat menjalankan image armv7l maupun aarch64 karena CPU-nya mendukung kedua instruction set. Perbedaannya: armv7l = sistem 32-bit, aarch64 = sistem 64-bit.

Kernel Raspberry Pi 5

RPi 5 memiliki paket kernel tersendiri yang dioptimalkan dengan 16KB page size:

sudo xbps-install -S rpi5-kernel

Perintah ini akan menggantikan rpi-kernel dengan rpi5-kernel secara otomatis.

⚠️ Tidak semua perangkat lunak kompatibel dengan kernel yang menggunakan page size lebih besar. Periksa issue tracker untuk masalah yang diketahui.

Konfigurasi Hardware

Konfigurasi hardware RPi dilakukan melalui file /boot/config.txt. Utilitas raspi-config tidak tersedia di T4n OS — semua perubahan harus dilakukan manual pada file ini.

Audio

Hapus komentar pada baris berikut di /boot/config.txt:

dtparam=audio=on

Serial Console

Aktifkan layanan serial untuk login via serial console:

ln -s /etc/sv/agetty-ttyAMA0 /var/service/

Parameter serial juga dikonfigurasi di /boot/cmdline.txt, terutama:

console=ttyAMA0,115200

I2C

Tambahkan ke /boot/config.txt:

device_tree_param=i2c_arm=on

Tambahkan ke /boot/cmdline.txt:

bcm2708.vc_i2c_override=1

Buat file modules-load di /etc/modules-load.d/i2c.conf:

i2c-dev

Instal tools I2C dan verifikasi:

sudo xbps-install -S i2c-tools
i2cdetect -l

Output yang diharapkan:

i2c-1    i2c    bcm2835 I2C adapter    I2C adapter

Hardware RNG (Entropy)

Secara default, perangkat HWRNG tidak digunakan, yang bisa menyebabkan proses seeding /dev/random lambat saat boot — berdampak pada layanan seperti sshd.

sudo xbps-install -S rng-tools
ln -s /etc/sv/rngd /var/service/

Jika rngd menyebabkan CPU overload, paksa penggunaan HWRNG saja dengan membuat file /etc/sv/rngd/conf:

RNGD_OPTS='-x jitter -x pkcs11 -x rtlsdr -n hwrng'

Sesi Grafis

Paket mesa-dri menyediakan driver grafis untuk semua varian RPi, kompatibel dengan modesetting Xorg maupun Wayland.

Hapus komentar pada baris berikut di /boot/config.txt:

dtoverlay=vc4-kms-v3d

Konfigurasi Xorg

Jika diperlukan, buat file konfigurasi Xorg (contoh: /etc/X11/xorg.conf.d/99-rpi.conf):

Section "OutputClass"
    Identifier "vc4"
    MatchDriver "vc4"
    Driver "modesetting"
    Option "PrimaryGPU" "true"
EndSection

Konfigurasi

Bagian ini berisi informasi tentang cara mengkonfigurasi T4n OS.

Dokumentasi Paket

Media dokumentasi yang paling umum di T4n OS adalah halaman manual (man pages).

Banyak paket juga menyertakan dokumentasi dalam format lain seperti HTML, yang biasanya dapat ditemukan di direktori /usr/share/doc/<paket>.

Dokumentasi yang lebih lengkap mungkin dipisah ke dalam paket *-doc tersendiri, misalnya julia-doc. Ini umum terjadi pada bahasa pemrograman, database, dan library besar.

Selain dokumentasi dari upstream, beberapa paket juga menyertakan catatan setup awal atau penggunaan khusus T4n OS yang ditulis oleh kontributor distribusi. Catatan tersebut akan berada di:

/usr/share/doc/<paket>/README.voidlinux

Manual Pages

T4n OS menyertakan toolset manpage mandoc secara default melalui paket mdocml.

Gunakan perintah man untuk membuka halaman manual:

man chroot

Seksi Manual

Setiap halaman manual termasuk dalam seksi tertentu:

Beberapa halaman manual memiliki nama yang sama namun berada di seksi berbeda. Tentukan seksinya secara eksplisit jika diperlukan:

man 1 printf

man dapat dikonfigurasi melalui man.conf(5).

Pencarian dengan apropos

Toolset mandoc menyertakan apropos untuk mencari halaman manual berdasarkan kata kunci. apropos menggunakan database yang dibuat dan diperbarui dengan perintah makewhatis:

# Buat/perbarui database
sudo makewhatis

# Cari halaman manual
apropos chroot

Contoh output:

chroot(1)        - run command or interactive shell with special root directory
xbps-uchroot(1)  - XBPS utility to chroot and bind mount with Linux namespaces
xbps-uunshare(1) - XBPS utility to chroot and bind mount with Linux user namespaces
chroot(2)        - change root directory

Paket mdocml menyertakan cron job untuk memperbarui database secara harian di /etc/cron.daily/makewhatis. Pastikan cron daemon sudah terinstal dan aktif agar fitur ini berfungsi.

Paket Manual Tambahan

Manual pengembangan dan POSIX tidak terinstal secara default, namun tersedia melalui:

sudo xbps-install -S man-pages-devel man-pages-posix

Manual Pages dalam Bahasa Lain

Halaman manual yang dilokalisasi tersedia melalui paket manpages-* atau paket yang menyertakannya sendiri. Namun diperlukan sedikit konfigurasi.

Dengan mdocml

Jika menggunakan mdocml dan ingin pengaturan berlaku untuk semua pengguna, tambahkan path yang relevan ke man.conf. Contoh untuk bahasa Jerman:

/usr/share/man/de
/usr/share/man/de.UTF-8

Atau, setiap pengguna dapat mengekspor variabel MANPATH di environment shell masing-masing:

export MANPATH=/usr/share/man/de:/usr/share/man/de.UTF-8

Firmware

T4n OS menyediakan sejumlah paket firmware melalui repositorinya. Beberapa paket hanya tersedia setelah repositori nonfree diaktifkan.

Microcode

Microcode dimuat ke CPU atau GPU saat booting oleh BIOS, namun dapat diperbarui kemudian oleh sistem operasi. Pembaruan microcode memungkinkan perilaku CPU atau GPU dimodifikasi untuk mengatasi bug tertentu — tanpa perlu mengganti hardware.

Intel

Instal paket microcode Intel:

sudo xbps-install -S intel-ucode

Catatan: Paket ini berada di repositori nonfree. Pastikan repositori tersebut sudah diaktifkan sebelum melanjutkan.

Setelah instalasi, regenerasi initramfs secara manual:

sudo xbps-reconfigure -f linux<versi>

Pada pembaruan berikutnya, microcode akan ditambahkan ke initramfs secara otomatis.

AMD

Instal paket firmware AMD:

sudo xbps-install -S linux-firmware-amd

Paket ini mencakup microcode untuk CPU maupun GPU AMD. Microcode akan dimuat secara otomatis — tidak ada konfigurasi tambahan yang diperlukan.

Verifikasi

Untuk memverifikasi bahwa microcode berhasil dimuat, periksa informasi pada /proc/cpuinfo:

grep microcode /proc/cpuinfo

Menghapus Firmware

Secara default, paket linuxX.Y dan base-system menginstal sejumlah paket firmware. Firmware yang tidak terpakai tidak wajib dihapus, namun jika diperlukan, ikuti langkah berikut:

1. Konfigurasi XBPS untuk mengabaikan paket firmware yang tidak diinginkan.
2. Hapus paket tersebut dengan perintah:

sudo xbps-remove -R <nama-paket-firmware>

Locale

T4n OS mendukung pengaturan locale melalui dua implementasi C library:

• glibc — mendukung pengaturan locale sistem maupun bahasa aplikasi.
• musl — hanya mendukung pengaturan bahasa aplikasi (tidak mendukung locale sistem).

Melihat Locale Aktif

Untuk melihat daftar locale yang saat ini aktif:

locale -a

Mengaktifkan Locale

Edit file /etc/default/libc-locales, lalu hapus tanda komentar (#) pada locale yang diinginkan.

Sebelum:

# en_US.UTF-8 UTF-8
# id_ID.UTF-8 UTF-8

Sesudah:

en_US.UTF-8 UTF-8
id_ID.UTF-8 UTF-8

Kemudian, regenerasi paket glibc-locales:

sudo xbps-reconfigure -f glibc-locales

Mengatur Bahasa Sistem

Tetapkan variabel LANG di /etc/locale.conf:

LANG=id_ID.UTF-8

Locale untuk Aplikasi

Beberapa aplikasi menyimpan terjemahannya di paket terpisah yang perlu diinstal secara manual. Cari paket bahasa yang diinginkan di repositori:

xbps-query -Rs german
xbps-query -Rs portuguese

Instal paket yang sesuai dengan aplikasi yang digunakan.

Contoh — LibreOffice: Jika menginstal paket individual seperti libreoffice-writer, setidaknya satu paket libreoffice-i18n-* harus diinstal agar terjemahan tersedia. Jika menginstal meta-paket libreoffice, paket terjemahan umum sudah disertakan secara otomatis.

User & Grup

Manajemen User

Manajemen Grup

Default Shell

Untuk mengubah shell default user:

chsh -s <shell> <nama_user>

<shell> harus berupa path shell yang terdaftar di /etc/shells. Untuk melihat daftar shell yang tersedia:

chsh -l

sudo

sudo sudah terinstal secara default. Konfigurasi hanya diperlukan jika ingin menggunakannya.

Edit file sudoers menggunakan visudo sebagai root:

visudo

Untuk memberikan hak superuser, hapus tanda komentar pada baris berikut:

Sebelum:

#%wheel ALL=(ALL) ALL

Sesudah:

%wheel ALL=(ALL) ALL

Kemudian tambahkan user ke grup wheel:

usermod -aG wheel <nama_user>

Grup Default

T4n OS mendefinisikan sejumlah grup secara default:

Layanan dan Daemon — runit

T4n OS menggunakan runit sebagai supervision suite untuk menjalankan layanan sistem dan daemon.

Keunggulan runit:

• Codebase kecil — lebih mudah diaudit untuk bug dan masalah keamanan.
• Environment bersih — setiap layanan selalu dijalankan dengan environment variables, resource limits, dan file descriptor yang sama, terlepas dari bagaimana layanan tersebut dimulai atau di-restart.
• Logging andal — log service tetap berjalan selama layanan terkait masih aktif.

Jika tidak membutuhkan program yang berjalan terus-menerus, pertimbangkan menggunakan cron daemon untuk menjalankannya secara berkala.

Service Directory

Setiap layanan yang dikelola runit memiliki service directory tersendiri. Satu-satunya file yang wajib ada adalah:

• run — file executable yang menjalankan proses di foreground.

File dan direktori opsional lainnya:

Folder supervise akan dibuat secara otomatis saat pertama kali layanan dijalankan.

Konfigurasi Layanan

Sebagian besar layanan dapat dikonfigurasi melalui file conf di service directory-nya — tanpa perlu memodifikasi file layanan itu sendiri.

Periksa file run untuk melihat parameter yang tersedia. Beberapa layanan memiliki field seperti:

OPTS="--value ..."

di dalam file conf-nya.

Mengedit Layanan

Untuk melakukan modifikasi lebih lanjut:

1. Salin service directory ke nama direktori baru (agar tidak ditimpa saat update xbps-install).
2. Edit file layanan di direktori baru tersebut.
3. Hentikan dan nonaktifkan layanan lama.
4. Aktifkan layanan baru.

Runsvdir

Runsvdir adalah direktori di /etc/runit/runsvdir/ yang berisi symlink ke service directory yang aktif. Pada sistem yang sedang berjalan, runsvdir aktif dapat diakses melalui /var/service.

T4n OS menggunakan dua runsvdir bawaan:

Runsvdir tambahan dapat dibuat di /etc/runit/runsvdir/.

Boot ke Runsvdir Tertentu

Tambahkan nama runsvdir ke kernel command-line. Contoh, untuk boot ke mode single:

single

Penggunaan Dasar

sv up <layanan>       # Jalankan layanan
sv down <layanan>     # Hentikan layanan
sv restart <layanan>  # Restart layanan
sv status <layanan>   # Cek status layanan

<layanan> dapat berupa nama layanan di /var/service/ atau path lengkapnya.

Contoh:

# Cek status layanan tertentu
sv status dhcpcd

# Cek status semua layanan aktif
sv status /var/service/*

Mengaktifkan Layanan

Service directory tersedia di /etc/sv/. Untuk mengaktifkan layanan pada sistem yang sedang berjalan:

ln -s /etc/sv/<layanan> /var/service/

Jika sistem sedang tidak berjalan, link langsung ke runsvdir default:

ln -s /etc/sv/<layanan> /etc/runit/runsvdir/default/

Layanan yang sudah di-link akan otomatis berjalan saat boot dan restart jika berhenti, kecuali dinonaktifkan secara manual.

Mencegah Layanan Otomatis Start

Untuk membiarkan runit mengelola layanan tanpa memulainya saat boot, buat file down:

touch /etc/sv/<layanan>/down

Cara ini juga berguna untuk menonaktifkan layanan default seperti agetty untuk tty 1–6, sehingga update paket tidak akan mengaktifkannya kembali.

Menonaktifkan Layanan

Hapus symlink dari runsvdir yang sedang berjalan:

rm /var/service/<layanan>

Atau dari runsvdir default (jika sistem tidak sedang berjalan):

rm /etc/runit/runsvdir/default/<layanan>

Menguji Layanan

Sebelum mengaktifkan penuh, uji layanan terlebih dahulu dengan menjalankannya sekali:

touch /etc/sv/<layanan>/down
ln -s /etc/sv/<layanan> /var/service/
sv once <layanan>

Jika semuanya berjalan normal, hapus file down untuk mengaktifkan layanan secara permanen:

rm /etc/sv/<layanan>/down

Layanan Per-Pengguna

Layanan per-pengguna berguna untuk menjalankan proses secara otomatis atas nama pengguna tertentu, seperti:

• Membuka SSH tunnel.
• Menjalankan virtual machine.
• Menjalankan daemon secara berkala.

Metode 1: runsvdir

Cara paling dasar adalah membuat layanan sistem yang menjalankan runsvdir sebagai pengguna tertentu.

Keterbatasan: Layanan ini dimulai saat boot, sehingga tidak memiliki akses ke sesi grafis atau session bus D-Bus pengguna.

Membuat Layanan

Buat direktori layanan /etc/sv/runsvdir-<username> dengan script run berikut (pastikan executable):

#!/bin/sh

export USER="<username>"
export HOME="/home/<username>"

groups="$(id -Gn "$USER" | tr ' ' ':')"
svdir="$HOME/service"

exec chpst -u "$USER:$groups" runsvdir "$svdir"

Script ini menggunakan chpst untuk menjalankan runsvdir sebagai pengguna yang ditentukan. Variabel $USER dan $HOME diekspor karena beberapa layanan membutuhkannya.

Jadikan executable lalu aktifkan:

chmod +x /etc/sv/runsvdir-<username>/run
ln -s /etc/sv/runsvdir-<username> /var/service/

Menambahkan Layanan Pengguna

Buat direktori layanan di home folder, lalu tambahkan service di sana:

mkdir -p ~/service
# Tambahkan layanan atau symlink ke direktori ini

Mengontrol Layanan

# Cek status semua layanan pengguna
sv status ~/service/*

# Restart layanan tertentu menggunakan path
sv restart ~/service/gpg-agent

# Atau gunakan SVDIR agar tidak perlu menulis path lengkap
SVDIR=~/service sv restart gpg-agent

Tambahkan export SVDIR=~/service di profil shell (~/.bashrc atau ~/.zshrc) agar tidak perlu menulisnya setiap saat.

Metode 2: turnstile

turnstile mendukung layanan per-pengguna yang dimulai bersama sesi pengguna, menggunakan backend runit atau dinit.

Lokasi Service Directory

Jika menggunakan backend runit, simpan layanan pengguna di:

~/.config/service/

Layanan yang Wajib Jalan Sebelum Login

Untuk memastikan layanan tertentu sudah berjalan sebelum proses login selesai, daftarkan di ~/.config/service/turnstile-ready/conf:

core_services="dbus foo"

File turnstile-ready dibuat otomatis oleh turnstile pada login pertama.

Berbagi Environment Variables

Untuk memberikan akses environment variable ke layanan pengguna, gunakan fitur envdir dari chpst. Di dalam service, gunakan variabel TURNSTILE_ENV_DIR:

exec chpst -e "$TURNSTILE_ENV_DIR" nama-program

Untuk memperbarui variabel di envdir bersama:

turnstile-update-runit-env DISPLAY XAUTHORITY FOO=bar BAZ=

Menjalankan D-Bus Session Bus

Untuk menjalankan D-Bus session bus sebagai layanan yang dikelola turnstile:

mkdir -p ~/.config/service/dbus
ln -s /usr/share/examples/turnstile/dbus.run   ~/.config/service/dbus/run
ln -s /usr/share/examples/turnstile/dbus.check ~/.config/service/dbus/check

Perbandingan Metode

Logging

T4n OS tidak menginstal syslog daemon secara default. Beberapa implementasi tersedia di repositori.

Socklog (Disarankan)

socklog adalah implementasi syslog dari penulis runit — pilihan yang tepat jika belum tahu harus menggunakan yang mana.

sudo xbps-install -S socklog-void
ln -s /etc/sv/socklog-unix /var/service/
ln -s /etc/sv/nanoklogd    /var/service/

Pastikan tidak ada syslog daemon lain yang sedang berjalan.

Log disimpan di subdirektori /var/log/socklog/. Untuk membacanya dengan mudah:

svlogtail

Akses log dibatasi untuk root dan pengguna yang tergabung di grup socklog. Untuk menambahkan pengguna ke grup tersebut:

sudo usermod -aG socklog <nama_user>

Alternatif Lain

sudo xbps-install -S rsyslog   # atau metalog
ln -s /etc/sv/rsyslog /var/service/

rc.conf, rc.local, rc.shutdown, dan core-services

File-file ini digunakan untuk mengonfigurasi berbagai aspek sistem T4n OS. rc.conf biasanya sudah dikonfigurasi secara otomatis oleh installer.

Ringkasan

rc.conf

Dieksekusi di runit stage 1 dan 3. Berisi variabel konfigurasi sistem.

KEYMAP

Menentukan layout keyboard untuk Linux console. Daftar keymap tersedia di /usr/share/kbd/keymaps/.

KEYMAP=us   # Keyboard standar Amerika
KEYMAP=id   # Keyboard Indonesia (jika tersedia)

HARDWARECLOCK

Menentukan apakah hardware clock diatur ke UTC atau waktu lokal.

HARDWARECLOCK=utc        # Default — disarankan
HARDWARECLOCK=localtime  # Gunakan jika dual-boot dengan Windows

Catatan: Windows menggunakan localtime secara default. Jika dual-boot, pilih salah satu: ubah Windows agar menggunakan UTC, atau tetapkan variabel ini ke localtime.

FONT

Menentukan font yang digunakan di Linux console. Daftar font tersedia di /usr/share/kbd/consolefonts/.

FONT=eurlatgr

rc.local

Dieksekusi di runit stage 2. Berisi perintah atau konfigurasi yang dijalankan sebelum login, setiap kali sistem boot.

Contoh isi /etc/rc.local:

#!/bin/sh

# Aktifkan forwarding IP
echo 1 > /proc/sys/net/ipv4/ip_forward

rc.shutdown

Dieksekusi di runit stage 3 saat sistem shutdown. Berguna untuk menjalankan perintah pembersihan sebelum sistem mati.

Contoh isi /etc/rc.shutdown:

#!/bin/sh

# Sinkronisasi data sebelum shutdown
sync

core-services

Direktori /etc/runit/core-services/ berisi skrip shell yang dijalankan secara berurutan (alfabetis) di runit stage 1, sebelum layanan apa pun dimulai.

Cocok untuk konfigurasi startup satu kali (oneshot), seperti mengatur parameter kernel atau melakukan inisialisasi hardware.

Contoh oneshot script:

# /etc/runit/core-services/00-custom.sh
#!/bin/sh
echo "Konfigurasi awal berjalan..."

Cron

Cron adalah daemon untuk menjalankan program secara otomatis pada interval tertentu. Program dan jadwalnya ditentukan dalam file crontab.

Untuk mengedit crontab:

crontab -e       # Edit crontab milik user saat ini
sudo crontab -e  # Edit crontab sistem (superuser)

Instalasi

Cron daemon tidak terinstal secara default. T4n OS menyediakan beberapa pilihan implementasi:

Instal salah satu, contoh menggunakan cronie:

sudo xbps-install -S cronie

Aktifkan layanannya:

ln -s /etc/sv/cronie /var/service/

Catatan: Hindari menggunakan layanan generik crond dari sistem alternatif — tidak ada keuntungannya dan hanya mempersulit konfigurasi.

Alternatif: snooze

Sebagai alternatif dari cron tradisional, snooze dapat digunakan bersama runit.

sudo xbps-install -S snooze

Paket snooze menyediakan layanan berikut:

Aktifkan layanan yang dibutuhkan, contoh:

ln -s /etc/sv/snooze-daily /var/service/

Letakkan script yang ingin dijadwalkan di direktori yang sesuai, lalu pastikan file tersebut executable:

chmod +x /etc/cron.daily/nama-script

Solid State Drive (SSD)

Setelah instalasi, aktifkan TRIM pada SSD untuk menjaga performa dan umur panjang drive.

Cek Dukungan TRIM

Jalankan perintah berikut untuk melihat apakah perangkat mendukung TRIM:

lsblk --discard

Jika kolom DISC-GRAN dan DISC-MAX bernilai non-zero, berarti perangkat mendukung TRIM.

Jika partisi SSD tidak menampilkan dukungan TRIM, pastikan filesystem yang digunakan mendukungnya: ext4, Btrfs, F2FS (membutuhkan kernel 4.19 ke atas), dll.

Menjalankan TRIM Sekali (Manual)

sudo fstrim /

Otomatisasi TRIM

Ada dua pendekatan — pilih salah satu:

1. Periodic TRIM (via cron)

Buat script di /etc/cron.weekly/fstrim:

#!/bin/sh
fstrim /

Jadikan executable:

chmod u+x /etc/cron.weekly/fstrim

2. Continuous TRIM (via fstab)

Edit /etc/fstab dan tambahkan opsi discard pada partisi SSD. Contoh untuk /dev/sda1 dengan filesystem ext4:

/dev/sda1  /  ext4  defaults,discard  0  1

⚠️ Continuous TRIM tidak disarankan jika SSD tidak menangani NCQ dengan benar. Cek daftar blacklist kernel untuk referensi.

TRIM untuk LVM

Buka /etc/lvm/lvm.conf, hapus komentar pada opsi issue_discards dan set nilainya ke 1:

issue_discards=1

TRIM untuk LUKS

⚠️ Perhatian: Sebelum mengaktifkan discard pada partisi LUKS, pahami dulu implikasi keamanannya.

Membuka Device LUKS dengan Discard

sudo cryptsetup luksOpen --allow-discards /dev/sdaX luks

Partisi Non-Root

Edit /etc/crypttab dan tambahkan opsi discard. Contoh:

externaldrive1  /dev/sdb2  none  luks,discard

Partisi Root

Jika partisi root berada di LUKS, tambahkan rd.luks.allow-discards ke konfigurasi GRUB di /etc/default/grub:

GRUB_CMDLINE_LINUX_DEFAULT="rd.luks.allow-discards"

Perbarui GRUB:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Verifikasi Konfigurasi LUKS

Setelah reboot, jalankan:

sudo dmsetup table /dev/mapper/crypt_dev --showkeys

Jika output mengandung string allow_discards, TRIM pada LUKS berhasil diaktifkan.

TRIM untuk ZFS

Pastikan semua device dalam pool mendukung TRIM:

zpool get all | grep trim

TRIM Sekali (Manual)

sudo zpool trim yourpoolname

Periodic TRIM (via cron)

Buat script di /etc/cron.daily/ztrim:

#!/bin/sh
zpool trim yourpoolname

Jadikan executable:

chmod u+x /etc/cron.daily/ztrim

Autotrim

Untuk mengaktifkan autotrim secara permanen pada pool:

sudo zpool set autotrim=on yourpoolname

Autotrim dinonaktifkan (off) secara default.

Ringkasan Metode TRIM

Keamanan

Ada beberapa langkah yang dapat dilakukan untuk membuat instalasi T4n OS lebih aman. Bagian ini membahas beberapa di antaranya.

Daftar Isi

• AppArmor

AppArmor

AppArmor adalah mekanisme mandatory access control (seperti SELinux) yang membatasi program berdasarkan definisi kebijakan yang telah ditentukan sebelumnya.

T4n OS menyertakan profil default untuk beberapa layanan seperti dhcpcd dan wpa_supplicant. Container runtime seperti LXC dan Podman juga terintegrasi dengan AppArmor untuk keamanan container yang lebih baik.

Instalasi & Aktivasi

1. Instal Paket AppArmor

sudo xbps-install -S apparmor

2. Tambahkan Parameter ke Kernel Command Line

Edit /etc/default/grub dan tambahkan parameter berikut ke GRUB_CMDLINE_LINUX_DEFAULT:

apparmor=1 security=apparmor

Lalu perbarui GRUB:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Reboot agar perubahan diterapkan.

Mode AppArmor

Mode loading profil diatur melalui variabel APPARMOR di /etc/default/apparmor:

Contoh untuk mengaktifkan mode enforce:

# /etc/default/apparmor
APPARMOR=enforce

Tools AppArmor

Untuk menggunakan tool pembuatan profil (aa-genprof, aa-logprof), salah satu dari berikut harus aktif:

• syslog daemon — lihat dokumentasi Logging.
• auditd — instal dan aktifkan layanan auditd.

sudo xbps-install -S audit
ln -s /etc/sv/auditd /var/service/

Tanggal dan Waktu

Untuk melihat atau mengubah tanggal dan waktu sistem secara langsung, gunakan perintah date:

date

Timezone

Timezone Sistem (Global)

Set timezone default sistem dengan membuat symlink ke file zona waktu:

ln -sf /usr/share/zoneinfo/<timezone> /etc/localtime

Contoh untuk WIB:

ln -sf /usr/share/zoneinfo/Asia/Jakarta /etc/localtime

Catatan: Jika variabel TIMEZONE masih ada di /etc/rc.conf, hapus atau komentari baris tersebut — nilainya akan menimpa pengaturan ln di atas setiap kali reboot.

Timezone Per Pengguna

Untuk mengatur timezone hanya untuk pengguna tertentu, ekspor variabel TZ di file profil shell (contoh: ~/.bashrc atau ~/.zshrc):

export TZ=<timezone>

Mengatur timezone tidak mengubah waktu itu sendiri — hanya menentukan offset dari UTC.

Hardware Clock

Secara default, T4n OS menyimpan waktu hardware clock dalam format UTC.

Jika kamu melakukan dual-boot dengan Windows (yang secara default menggunakan localtime), akan terjadi konflik waktu. Ada dua solusi:

• Rekomendasi: Ubah Windows agar menggunakan UTC.
• Alternatif: Ubah T4n OS agar menggunakan localtime dengan menambahkan baris berikut di /etc/rc.conf:

export HARDWARECLOCK=localtime

NTP (Sinkronisasi Waktu Jaringan)

Untuk menjaga akurasi jam sistem, gunakan Network Time Protocol (NTP). T4n OS menyediakan beberapa pilihan daemon NTP:

Instalasi & Aktifkan Layanan

Instal salah satu paket NTP, contoh menggunakan Chrony:

sudo xbps-install -S chrony

Aktifkan layanannya:

ln -s /etc/sv/chronyd /var/service/

Atau gunakan xbps-alternatives jika tersedia sebagai ntpd service.

Perbandingan Daemon NTP

• ISC NTP — implementasi klasik, stabil, dan paling banyak didokumentasikan → ntp.org
• OpenNTPD — minimalis dan aman, cocok untuk kebutuhan umum → openntpd.org
• Chrony — sinkronisasi lebih cepat, cocok untuk laptop atau koneksi tidak stabil → chrony-project.org
• ntpd-rs — implementasi modern di Rust, mendukung NTS (Network Time Security) → docs.ntpd-rs.pendulum-project.org

Kernel

Seri Kernel

T4n OS menyediakan beberapa seri kernel di repositori default dengan penamaan linux<x>.<y>. Untuk melihat semua seri yang tersedia:

xbps-query --regex -Rs '^linux[0-9.]+-[0-9._]+' | sort -Vrk2

Meta-paket linux yang terinstal secara default bergantung pada salah satu paket kernel — biasanya kernel mainline terbaru yang kompatibel dengan semua modul DKMS. Kernel yang lebih baru mungkin tersedia di repositori, namun belum tentu cukup stabil untuk dijadikan default — gunakan dengan risiko sendiri.

Jika ingin menggunakan kernel lebih baru dan membutuhkan modul DKMS:

# Instal paket headers sesuai versi kernel
sudo xbps-install -S linux<x>.<y>-headers

# Reconfigure kernel untuk membangun modul DKMS
sudo xbps-reconfigure linux<x>.<y>

Menghapus Kernel Lama

Saat kernel diperbarui, versi lama tetap disimpan sebagai cadangan rollback. Seiring waktu, kernel lama dapat menumpuk dan:

• Menghabiskan ruang disk.
• Memperlambat proses update modul DKMS.
• Jika /boot adalah partisi terpisah dan penuh, update bisa gagal atau menghasilkan initramfs yang tidak lengkap dan menyebabkan kernel panic.

Gunakan vkpurge untuk membersihkan kernel lama:

sudo vkpurge rm <versi>     # Hapus versi tertentu
sudo vkpurge rm all         # Hapus semua kernel lama

vkpurge sudah terinstal secara default. Perintah ini hanya menghapus kernel tertentu, bukan paket kernel-nya.

Menghapus Seri Kernel Default

Jika sudah menginstal seri kernel lain dan ingin menghapus kernel default:

1. Instal atau tandai linux-base sebagai manual package:

sudo xbps-install -S linux-base
# atau jika sudah terinstal:
sudo xbps-pkgdb -m manual linux-base

2. Tambahkan linux dan linux-headers ke ignorepkg di /etc/xbps.d/*.conf:

ignorepkg=linux linux-headers

3. Hapus paket kernel default:

sudo xbps-remove linux linux-headers

Beralih ke Seri Kernel Lain

Untuk beralih ke linux-lts atau linux-mainline:

# Instal seri kernel yang diinginkan
sudo xbps-install -S linux-lts linux-lts-headers

# Tambahkan ke ignorepkg agar tidak ditimpa
# Edit /etc/xbps.d/*.conf:
# ignorepkg=linux linux-headers

# Hapus kernel default
sudo xbps-remove linux linux-headers

Mengganti Generator initramfs

Secara default, T4n OS menggunakan dracut untuk membuat initramfs. Alternatif seperti mkinitcpio juga tersedia.

Untuk beralih ke mkinitcpio:

# Instal mkinitcpio
sudo xbps-install -S mkinitcpio

# Cek daftar alternatif yang tersedia
xbps-alternatives -l -g initramfs

# Set mkinitcpio sebagai generator aktif
sudo xbps-alternatives -s mkinitcpio

# Regenerasi initramfs secara paksa
sudo xbps-reconfigure -f linux<x>.<y>

Kernel Command Line

Parameter kernel dapat dikonfigurasi saat boot. File /proc/cmdline berisi parameter yang aktif saat ini:

cat /proc/cmdline

Melalui GRUB

Edit /etc/default/grub, ubah variabel GRUB_CMDLINE_LINUX_DEFAULT, lalu perbarui GRUB:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Melalui dracut

dracut menyediakan opsi kernel_cmdline di file konfigurasinya. Setelah mengubah konfigurasi dracut, regenerasi initramfs:

sudo xbps-reconfigure -f linux<x>.<y>

Catatan: Opsi ini hanya efektif jika dracut membuat UEFI executable. Untuk initramfs biasa, parameter ditulis ke /etc/cmdline.d di dalam image dan hanya dibaca oleh dracut sendiri — bukan oleh kernel.

Kernel Hardening

T4n OS mengaktifkan beberapa opsi keamanan kernel secara default. Sejak kernel 5.3, opsi lama (slub_debug=P, page_poison=1) digantikan oleh:

Untuk mengaktifkan init_on_free, tambahkan ke kernel command line:

init_on_free=1

Untuk menonaktifkan init_on_alloc (tidak disarankan):

init_on_alloc=0

Jika masih menggunakan kernel di bawah 5.4 dan opsi lama masih aktif, pertimbangkan untuk menghapusnya karena dampak performanya setara dengan init_on_free=1.

Kernel Modules

Memuat Modul Saat Boot

Buat file .conf di /etc/modules-load.d/. Contoh untuk memuat virtio-net:

# /etc/modules-load.d/virtio.conf
virtio-net

Blacklist Modul

Modul yang Dimuat Setelah initramfs

Buat file .conf di /etc/modprobe.d/. Contoh untuk blacklist radeon:

# /etc/modprobe.d/radeon.conf
blacklist radeon

Modul dalam initramfs

Setelah mengubah konfigurasi, regenerasi initramfs agar perubahan diterapkan saat boot berikutnya.

dracut — buat file di /etc/dracut.conf.d/:

# /etc/dracut.conf.d/radeon.conf
omit_drivers+=" radeon "

mkinitcpio — buat file di /etc/modprobe.d/:

# /etc/modprobe.d/radeon.conf
blacklist radeon

Kernel Hooks

T4n OS menyediakan direktori untuk kernel hooks di:

/etc/kernel.d/pre-install/
/etc/kernel.d/post-install/
/etc/kernel.d/pre-remove/
/etc/kernel.d/post-remove/

Hooks ini digunakan untuk memperbarui boot menu bootloader seperti GRUB.

Untuk menerapkan perubahan konfigurasi initramfs secara manual:

sudo xbps-reconfigure --force linux<x>.<y>

DKMS (Dynamic Kernel Module Support)

Beberapa modul kernel di luar source tree Linux dibangun saat instalasi menggunakan DKMS. Untuk melihat modul yang tersedia:

xbps-query -Rs dkms

Log build DKMS tersimpan di:

/var/lib/dkms/

Manajemen Daya

acpid

acpid menangani event ACPI seperti tombol power, tutup lid, dan lainnya. Jika T4n OS diinstal dari live image menggunakan sumber lokal, layanan ini sudah aktif secara default.

Event ACPI ditangani oleh script /etc/acpi/handler.sh, yang menggunakan zzz untuk event suspend-to-RAM.

Untuk mengaktifkan secara manual:

ln -s /etc/sv/acpid /var/service/

elogind

elogind juga memproses event ACPI — termasuk lid switch, tombol power, suspend, dan hibernate.

⚠️ Konflik: elogind dan acpid tidak boleh aktif bersamaan untuk menangani event ACPI yang sama.

Ada dua cara menghindari konflik:

Opsi 1 — Nonaktifkan acpid saat menggunakan elogind:

rm /var/service/acpid

Opsi 2 — Biarkan acpid tetap aktif, tapi set elogind agar mengabaikan event ACPI. Edit /etc/elogind/logind.conf dan set semua opsi yang diawali Handle menjadi ignore:

HandlePowerKey=ignore
HandleSuspendKey=ignore
HandleHibernateKey=ignore
HandleLidSwitch=ignore
HandleLidSwitchExternalPower=ignore

Poweroff & Reboot Tanpa Root

Agar perintah loginctl poweroff dan loginctl reboot dapat dijalankan tanpa hak root, instal polkit:

sudo xbps-install -S polkit

Hemat Daya — TLP (Laptop)

Untuk memperpanjang masa pakai baterai laptop, gunakan TLP:

sudo xbps-install -S tlp
ln -s /etc/sv/tlp /var/service/

TLP bekerja secara otomatis di latar belakang setelah layanan diaktifkan. Lihat dokumentasi TLP untuk konfigurasi lanjutan.

Ringkasan

Jaringan

T4n OS menggunakan NetworkManager sebagai pengelola jaringan default. Konfigurasi jaringan juga dapat dilakukan dengan berbagai cara lain sesuai kebutuhan.

Nama Interface

Versi udev terbaru tidak lagi menggunakan skema penamaan tradisional (eth0, wlan0, dll.) — digantikan dengan nama seperti enp3s0, wlp2s0, dan sejenisnya.

Untuk kembali ke penamaan tradisional, tambahkan parameter berikut ke kernel command line di /etc/default/grub:

net.ifnames=0

Lalu perbarui GRUB:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Konfigurasi IP Statis

Tambahkan perintah ip berikut ke /etc/rc.local untuk mengatur IP statis saat boot:

ip link set dev eth0 up
ip addr add 192.168.1.2/24 brd + dev eth0
ip route add default via 192.168.1.1

Sesuaikan nama interface, IP address, dan gateway sesuai jaringan kamu.

Bridge Interface

Untuk mengonfigurasi bridge interface saat boot, tambahkan ke /etc/rc.local:

ip link add name br0 type bridge
ip link set eth0 master br0
ip link set eth0 up

dhcpcd

Semua Interface

Untuk menjalankan dhcpcd di semua interface:

ln -s /etc/sv/dhcpcd /var/service/

Interface Tertentu

Untuk menjalankan dhcpcd hanya pada interface tertentu, cek nama interface terlebih dahulu:

ip link show

Salin service template dan sesuaikan dengan nama interface:

cp -R /etc/sv/dhcpcd-eth0 /etc/sv/dhcpcd-enp3s0
ln -nsf /run/runit/supervise.dhcpcd-enp3s0 /etc/sv/dhcpcd-enp3s0/supervise
sed -i 's/eth0/enp3s0/' /etc/sv/dhcpcd-enp3s0/run
ln -s /etc/sv/dhcpcd-enp3s0 /var/service/

Ganti enp3s0 dengan nama interface yang sesuai di sistem kamu.

WiFi

Sebelum terhubung ke jaringan wireless, cek apakah interface WiFi terblokir:

rfkill list

Jika terblokir secara software (soft-blocked), buka blokirnya:

rfkill unblock wifi

T4n OS menyediakan beberapa pilihan untuk koneksi WiFi:

Firewall

IWD (iNet Wireless Daemon)

IWD adalah daemon WiFi modern untuk Linux, dirancang sebagai pengganti wpa_supplicant.

Instalasi

sudo xbps-install -S iwd
ln -s /etc/sv/dbus /var/service/
ln -s /etc/sv/iwd  /var/service/

Penggunaan (iwctl)

iwctl adalah client command-line untuk mengelola koneksi WiFi.

iwctl          # Masuk ke sesi interaktif
iwctl help     # Tampilkan daftar perintah

Secara default, hanya root dan anggota grup wheel yang dapat menjalankan iwctl.

Contoh Penggunaan Cepat

# Lihat daftar perangkat WiFi
iwctl device list

# Scan jaringan
iwctl station wlan0 scan

# Lihat hasil scan
iwctl station wlan0 get-networks

# Hubungkan ke jaringan
iwctl station wlan0 connect <SSID>

Konfigurasi

Konfigurasi Daemon

File konfigurasi utama: /etc/iwd/main.conf

Jika belum ada, buat file tersebut:

sudo mkdir -p /etc/iwd
sudo nano /etc/iwd/main.conf

Konfigurasi Jaringan

IWD menyimpan informasi jaringan di /var/lib/iwd/. Format nama file:

<SSID>.open    # Jaringan terbuka
<SSID>.psk     # WPA2/PSK
<SSID>.8021x   # WPA Enterprise

Contoh konfigurasi jaringan WPA2/PSK — buat file /var/lib/iwd/<ssid>.psk:

[Security]
Passphrase=password_wifi_kamu

Troubleshooting

Konflik dengan udevd (Penamaan Interface)

IWD secara default membuat dan menghapus interface wireless (contoh: wlan0), yang bisa bentrok dengan udevd saat mencoba mengganti namanya.

Gejala — muncul pesan error seperti:

udevd: Error changing net interface name wlan0 to wlp59s0: Device or resource busy

Solusi 1 (disarankan) — Cegah IWD memanipulasi interface. Tambahkan ke /etc/iwd/main.conf:

[General]
UseDefaultInterface=true

Solusi 2 — Nonaktifkan penamaan persistent dari udevd (berlaku untuk semua perangkat jaringan):

# Opsi A: tambahkan ke kernel cmdline di /etc/default/grub
net.ifnames=0

# Opsi B: masking rule udevd
sudo ln -s /dev/null /etc/udev/rules.d/80-net-name-slot.rules

ConnMan

ConnMan adalah daemon manajemen jaringan yang ringan dan hemat resource — cocok untuk sistem embedded atau setup minimal.

Instalasi

sudo xbps-install -S connman

Mengaktifkan ConnMan

Sebelum mengaktifkan ConnMan, nonaktifkan daemon jaringan lain yang sedang berjalan untuk menghindari konflik:

# Nonaktifkan layanan yang mungkin aktif
rm -f /var/service/dhcpcd
rm -f /var/service/wpa_supplicant
rm -f /var/service/wicd

Kemudian aktifkan ConnMan:

ln -s /etc/sv/connmand /var/service/

Penggunaan (connmanctl)

connmanctl adalah client command-line untuk mengelola koneksi jaringan. Jalankan tanpa argumen untuk masuk ke sesi interaktif:

connmanctl

Contoh Koneksi ke WiFi

> enable wifi
> agent on
> scan wifi
> services
> connect wifi_<uniqueid>
> exit

Ganti wifi_<uniqueid> dengan ID jaringan yang muncul di output perintah services.

Front-End GUI

Selain CLI, ConnMan tersedia dengan berbagai antarmuka grafis:

sudo xbps-install -S cmst   # Contoh: instal UI berbasis Qt

Mencegah ConnMan Menimpa DNS

Secara default, ConnMan dapat menimpa konfigurasi DNS sistem. Untuk mencegahnya, buat file /etc/sv/connmand/conf:

OPTS="--nodnsproxy"

NetworkManager

NetworkManager adalah daemon manajemen jaringan default T4n OS — mendukung Ethernet, WiFi, dan mobile broadband.

Instalasi

sudo xbps-install -S NetworkManager

Mengaktifkan NetworkManager

1. Nonaktifkan Daemon Jaringan Lain

Pastikan tidak ada daemon jaringan lain yang aktif untuk menghindari konflik:

rm -f /var/service/dhcpcd
rm -f /var/service/wpa_supplicant
rm -f /var/service/wicd

2. Aktifkan D-Bus

NetworkManager membutuhkan dbus untuk berjalan:

ln -s /etc/sv/dbus /var/service/

3. Aktifkan NetworkManager

ln -s /etc/sv/NetworkManager /var/service/

Konfigurasi

Tambahkan pengguna ke grup network agar dapat mengelola koneksi:

sudo usermod -aG network <nama_user>

Tools Bawaan

Contoh Penggunaan nmcli

# Lihat status koneksi
nmcli

# Lihat daftar WiFi
nmcli device wifi list

# Hubungkan ke WiFi
nmcli device wifi connect <SSID> password <password>

# Lihat semua koneksi tersimpan
nmcli connection show

Front-End GUI

Eduroam (Jaringan Kampus)

Eduroam adalah layanan internet aman untuk civitas akademika yang bisa diakses di berbagai universitas di seluruh dunia.

Instalasi

1. Instal dependensi:

sudo xbps-install -S python3-dbus

2. Unduh installer eduroam sesuai institusi dari cat.eduroam.org.

3. Jalankan installer:

chmod +x eduroam_installer.py
python3 eduroam_installer.py

Installer akan memandu proses konfigurasi secara otomatis.

wpa_supplicant

wpa_supplicant sudah terinstal di sistem dasar T4n OS. Paket ini menyediakan tool untuk mengonfigurasi interface wireless dan menangani protokol keamanan WiFi.

Contoh konfigurasi lengkap tersedia di:

/usr/share/examples/wpa_supplicant/wpa_supplicant.conf

Konfigurasi Jaringan

WPA2/WPA-PSK (Paling Umum)

Generate pre-shared key lalu simpan ke file konfigurasi:

wpa_passphrase <SSID> <password> >> /etc/wpa_supplicant/wpa_supplicant.conf

WPA3-SAE

Tambahkan blok berikut ke wpa_supplicant.conf:

network={
    ssid="NamaWiFi"
    key_mgmt=SAE
    sae_password="PasswordWiFi"
    ieee80211w=2
}

WPA-EAP (Jaringan Institusi / Eduroam)

WPA-EAP tidak menggunakan PSK. Untuk membuat hash password:

echo -n <password> | iconv -t utf16le | openssl md4

WEP (Lama, Tidak Disarankan)

network={
    ssid="NamaWiFi"
    key_mgmt=NONE
    wep_key0="WEP_KEY_KAMU"
    wep_tx_keyidx=0
    auth_alg=SHARED
}

⚠️ WEP sudah dianggap tidak aman. Gunakan WPA2 atau WPA3 jika memungkinkan.

Konfigurasi Layanan

File konfigurasi layanan: /etc/sv/wpa_supplicant/conf

Jika file conf tidak ditemukan, layanan akan mencari secara otomatis di /etc/wpa_supplicant/:

• wpa_supplicant-<interface>.conf — terikat ke interface tertentu.
• wpa_supplicant.conf — digunakan untuk semua interface lainnya.

Mengaktifkan Layanan

ln -s /etc/sv/wpa_supplicant /var/service/

Menggunakan wpa_cli

Saat menggunakan wpa_cli, selalu tentukan interface dengan opsi -i:

wpa_cli -i wlp2s0

Tanpa opsi -i, perintah seperti scan dan scan_results mungkin tidak menghasilkan output yang diharapkan.

Contoh Perintah Interaktif

> scan
> scan_results
> add_network
> set_network 0 ssid "NamaWiFi"
> set_network 0 psk "PasswordWiFi"
> enable_network 0
> save_config
> quit

dhcpcd

dhcpcd adalah DHCP client daemon yang bertugas meminta dan mengelola IP address secara otomatis dari router/server DHCP di jaringan. Ringan dan cocok untuk setup sederhana tanpa membutuhkan fitur manajemen jaringan yang kompleks.

Catatan: T4n OS menggunakan NetworkManager sebagai default. Gunakan dhcpcd hanya jika kamu tidak menggunakan NetworkManager, IWD, ConnMan, atau daemon jaringan lainnya — menjalankan lebih dari satu daemon jaringan secara bersamaan akan menyebabkan konflik.

Instalasi

sudo xbps-install -S dhcpcd

Mengaktifkan dhcpcd

Semua Interface

Untuk menjalankan dhcpcd di semua interface sekaligus:

ln -s /etc/sv/dhcpcd /var/service/

Interface Tertentu

Untuk menjalankan dhcpcd hanya pada interface tertentu, cek nama interface terlebih dahulu:

ip link show

Salin service template dan sesuaikan dengan nama interface:

cp -R /etc/sv/dhcpcd-eth0 /etc/sv/dhcpcd-enp3s0
ln -nsf /run/runit/supervise.dhcpcd-enp3s0 /etc/sv/dhcpcd-enp3s0/supervise
sed -i 's/eth0/enp3s0/' /etc/sv/dhcpcd-enp3s0/run
ln -s /etc/sv/dhcpcd-enp3s0 /var/service/

Ganti enp3s0 dengan nama interface yang sesuai di sistem kamu.

Konfigurasi

File konfigurasi utama: /etc/dhcpcd.conf

IP Statis

Untuk mengatur IP statis pada interface tertentu, tambahkan ke /etc/dhcpcd.conf:

interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8

IP Statis untuk Beberapa Interface

interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=8.8.8.8

interface wlan0
static ip_address=192.168.1.101/24
static routers=192.168.1.1
static domain_name_servers=8.8.8.8

Fallback ke IP Statis

Jika DHCP gagal, dhcpcd dapat jatuh kembali ke IP statis:

profile static_eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=8.8.8.8

interface eth0
fallback static_eth0

Menonaktifkan IPv6

Tambahkan baris berikut ke /etc/dhcpcd.conf untuk menonaktifkan IPv6 pada interface tertentu:

interface eth0
noipv6

Atau nonaktifkan untuk semua interface:

noipv6

Mengelola dhcpcd

Cek Status

sv status dhcpcd

Restart

sv restart dhcpcd

Memperbarui Lease DHCP Secara Manual

sudo dhcpcd -n eth0   # Renew lease
sudo dhcpcd -k eth0   # Lepas lease (release)

Melihat Info Lease Aktif

cat /var/lib/dhcpcd/dhcpcd-eth0.lease

Troubleshooting

dhcpcd Tidak Mendapat IP

Cek apakah interface sudah aktif:

ip link show eth0

Jika status DOWN, aktifkan dulu:

sudo ip link set eth0 up

Konflik dengan Daemon Lain

Pastikan tidak ada daemon jaringan lain yang aktif:

sv status NetworkManager
sv status wpa_supplicant
sv status connmand

Nonaktifkan yang tidak diperlukan:

rm -f /var/service/NetworkManager
rm -f /var/service/wpa_supplicant

Log dhcpcd

svlogtail dhcpcd   # Jika menggunakan socklog
# atau
journalctl -u dhcpcd

Network Filesystem

NFS

Instalasi

sudo xbps-install -S nfs-utils

Untuk mount otomatis saat boot, instal juga sv-netmount:

sudo xbps-install -S sv-netmount

Mounting NFS Share (Client)

Mount Manual

sudo mount -t <tipe_mount> <host>:/path/sumber /path/tujuan

Contoh — mount /volume dari server 192.168.1.99 ke /mnt/volume:

sudo mount -t nfs 192.168.1.99:/volume /mnt/volume

Mount Otomatis saat Boot (fstab)

Tambahkan entri berikut ke /etc/fstab:

192.168.1.99:/volume  /mnt/volume  nfs  rw,hard  0  0

Aktifkan Layanan (NFSv3 dan Lebih Lama)

Client dan server yang menggunakan NFSv3 atau protokol lama memerlukan layanan berikut:

ln -s /etc/sv/rpcbind /var/service/
ln -s /etc/sv/statd   /var/service/

NFSv4 eksklusif tidak memerlukan layanan rpcbind dan statd.

Setup Server NFS (NFSv4, tanpa Kerberos)

1. Konfigurasi Exports

Edit /etc/exports dan tambahkan direktori yang ingin dibagikan:

/storage/foo    *.local(rw,no_subtree_check,no_root_squash)

Baris di atas membagikan /storage/foo ke semua host di domain lokal dengan akses baca/tulis.

2. Aktifkan Layanan

ln -s /etc/sv/rpcbind    /var/service/
ln -s /etc/sv/statd      /var/service/
ln -s /etc/sv/nfs-server /var/service/

3. Verifikasi Share

sudo showmount -e localhost

Konfigurasi Server Lanjutan

Hanya Menggunakan NFSv4

Edit /etc/nfs.conf dan tambahkan bagian berikut untuk menonaktifkan protokol lama:

[nfsd]
vers3=n
vers4=y
vers4.1=y
vers4.2=y

Verifikasi versi yang aktif:

cat /proc/fs/nfsd/versions

Manajemen Sesi dan Seat

Manajemen sesi tidak wajib untuk semua setup, namun berguna untuk:

• Membuat direktori runtime sementara secara aman.
• Memberikan akses ke perangkat hardware.
• Mendukung multi-seat.
• Mengontrol shutdown sistem.

D-Bus

D-Bus adalah mekanisme IPC (inter-process communication) yang digunakan oleh perangkat lunak di Linux. D-Bus menyediakan dua jenis bus:

Mengaktifkan System Bus

ln -s /etc/sv/dbus /var/service/

Mungkin perlu reboot agar berfungsi dengan benar.

Session Bus

Desktop environment yang diluncurkan melalui display manager biasanya sudah menginisiasi session bus sendiri. Untuk memeriksanya:

echo $DBUS_SESSION_BUS_ADDRESS

Jika variabel ini terdefinisi, session bus sudah aktif.

Ekspor Variabel Display ke D-Bus

Saat menggunakan session bus, mungkin perlu mengekspor variabel display:

# Untuk X / XWayland
dbus-update-activation-environment DISPLAY

# Untuk Wayland
dbus-update-activation-environment WAYLAND_DISPLAY

elogind

elogind mengelola login pengguna dan daya sistem — versi standalone dari systemd-logind. Berguna untuk:

• Sebagian besar desktop environment dan Wayland compositor.
• Xorg tanpa root (rootless Xorg).

Baca bagian Manajemen Daya sebelum menginstal elogind, terutama soal konflik dengan acpid.

Instalasi

sudo xbps-install -S elogind

Pastikan system D-Bus sudah aktif, lalu login ulang.

Jika mengalami masalah, aktifkan layanan elogind secara eksplisit (menunggu aktivasi D-Bus dapat menyebabkan error):

ln -s /etc/sv/elogind /var/service/

turnstile

turnstile adalah session manager alternatif yang bisa digunakan dengan atau tanpa elogind.

Dengan elogind

Nonaktifkan manajemen XDG_RUNTIME_DIR di /etc/turnstile/turnstiled.conf:

manage_rundir=no

elogind dan turnstile saat ini bisa berjalan berdampingan, namun hal ini bisa berubah di versi mendatang.

Tanpa elogind

Pertimbangkan untuk menginstal dan mengaktifkan:

• seatd — untuk manajemen seat.
• acpid — untuk manajemen daya.

Mengaktifkan turnstile

ln -s /etc/sv/turnstiled /var/service/

Lalu login ulang.

turnstile juga dapat mengelola per-user services termasuk menjalankan session bus D-Bus, sehingga tidak perlu lagi membungkus sesi grafis dengan dbus-run-session.

seatd

seatd adalah daemon manajemen seat yang minimal — alternatif ringan dari elogind, terutama untuk wlroots compositor (Sway, Hyprland, dll.).

sudo xbps-install -S seatd
ln -s /etc/sv/seatd /var/service/

Untuk mengizinkan user non-root mengakses sesi seatd:

sudo usermod -aG _seatd <nama_user>

Berbeda dengan elogind, seatd hanya menangani manajemen seat — tidak lebih.

XDG_RUNTIME_DIR

XDG_RUNTIME_DIR adalah variabel environment yang menentukan direktori runtime milik pengguna sesuai spesifikasi XDG Base Directory.

Otomatis

Instal elogind atau turnstile — keduanya akan mengatur XDG_RUNTIME_DIR secara otomatis.

Manual

Buat direktori dan set permission yang tepat:

mkdir -p /run/user/$(id -u)
chmod 700 /run/user/$(id -u)

Ekspor variabel di profil shell (~/.bashrc atau ~/.zshrc):

export XDG_RUNTIME_DIR=/run/user/$(id -u)

Ringkasan Pilihan

Graphical Session (Sesi Grafis)

Sesi grafis adalah lingkungan desktop interaktif yang memungkinkan pengguna berinteraksi dengan sistem operasi melalui antarmuka visual. Dokumen ini mencakup konfigurasi driver grafis, pemilihan display server, hingga pemasangan desktop environment di T4n OS.

Driver Grafis

Konfigurasi driver untuk kartu grafis yang digunakan.

• AMD / ATI
• Intel
• NVIDIA
• NVIDIA Optimus

Session (Display Server)

Pilih display server yang akan digunakan sebagai fondasi sesi grafis.

• X11 (Xorg) — Display server klasik, kompatibilitas luas.
• Wayland — Display server modern, keamanan lebih baik.
• XDG Desktop Portal — Komponen layanan sesi grafis.

GUI Core

• XFCE — Desktop environment ringan berbasis X11.
• XFCE Wayland — XFCE dengan dukungan Wayland.

GUI Extra

Kustomisasi tampilan sistem.

• Fonts — Instalasi dan konfigurasi font.
• Icons — Paket ikon.
• Themes — Tema GTK dan Qt.

Graphics Driver

Graphics driver di Linux adalah perangkat lunak yang menjembatani sistem operasi dengan kartu grafis (GPU), memungkinkan konversi data digital menjadi gambar di layar.

Driver Grafis

Konfigurasi driver untuk kartu grafis yang digunakan.

• AMD / ATI
• Intel
• NVIDIA
• NVIDIA Optimus

Driver GPU AMD / ATI

Firmware

Dukungan GPU AMD membutuhkan paket linux-firmware-amd.

• Jika menggunakan paket linux atau linux-lts → firmware sudah terinstal otomatis sebagai dependensi.
• Jika menggunakan kernel versi spesifik (contoh: linux5.4) → instal secara manual:

sudo xbps-install -S linux-firmware-amd

OpenGL

sudo xbps-install -S mesa-dri

Sudah termasuk dalam meta-paket xorg. Hanya perlu diinstal manual jika menggunakan xorg-minimal atau Wayland compositor.

Vulkan

sudo xbps-install -S vulkan-loader

Pilih salah satu atau keduanya sebagai driver Vulkan AMD:

sudo xbps-install -S mesa-vulkan-radeon   # Pilihan umum
# atau
sudo xbps-install -S amdvlk

Driver Xorg

Meta-paket xorg otomatis menarik xf86-video-amdgpu dan xf86-video-ati. Jika menggunakan xorg-minimal, pilih driver sesuai hardware:

sudo xbps-install -S xf86-video-amdgpu   # GPU modern
# atau
sudo xbps-install -S xf86-video-ati      # GPU lama

Akselerasi Video

VA-API

sudo xbps-install -S mesa-vaapi

Set environment variable agar driver AMD digunakan:

export LIBVA_DRIVER_NAME=radeonsi

Tambahkan ke ~/.bashrc atau ~/.zshrc agar permanen.

VDPAU

sudo xbps-install -S libvdpau-va-gl

Set environment variable:

export VDPAU_DRIVER=va_gl

Driver GPU Intel

Firmware

Dukungan GPU Intel membutuhkan paket linux-firmware-intel.

• Jika menggunakan paket linux atau linux-lts → firmware sudah terinstal otomatis sebagai dependensi.
• Jika menggunakan kernel versi spesifik (contoh: linux5.4) → instal secara manual:

sudo xbps-install -S linux-firmware-intel

OpenGL

sudo xbps-install -S mesa-dri

Sudah termasuk dalam meta-paket xorg. Hanya perlu diinstal manual jika menggunakan xorg-minimal atau Wayland compositor.

Vulkan

sudo xbps-install -S vulkan-loader mesa-vulkan-intel

Akselerasi Video

VA-API

Instal meta-paket intel-video-accel untuk mendapatkan semua driver yang diperlukan:

sudo xbps-install -S intel-video-accel

Secara default sistem menggunakan intel-media-driver. Untuk mengganti driver secara manual, gunakan variabel lingkungan LIBVA_DRIVER_NAME:

VDPAU

sudo xbps-install -S libvdpau-va-gl

Set environment variable:

export VDPAU_DRIVER=va_gl

Troubleshooting

Masalah IOMMU (Khusus Broadwell)

Kernel T4n OS dikonfigurasi dengan CONFIG_INTEL_IOMMU_DEFAULT_ON=y. Pada GPU generasi Broadwell, hal ini sering menyebabkan masalah driver grafis.

Tambahkan parameter berikut ke kernel command line untuk menonaktifkan IOMMU pada GPU internal:

intel_iommu=igfx_off

Jika GPU model lain mengalami masalah serupa dan teratasi dengan opsi ini, harap laporkan sebagai bug.

Gangguan Driver DDX

Pada chipset Intel yang lebih baru, driver DDX lama terkadang menyebabkan instabilitas atau akselerasi grafis tidak berjalan. Coba hapus semua paket xf86-video-*.

Beberapa chipset lama justru membutuhkan driver ini. Jika tampilan bermasalah setelah penghapusan, instal kembali paket xf86-video-intel.

Driver GPU NVIDIA

Di T4n OS tersedia dua pilihan driver: Nouveau (open-source) untuk stabilitas dan kompatibilitas Wayland, atau NVIDIA (proprietary) untuk performa maksimal.

Nouveau (Driver Open-Source)

Driver ini dikembangkan oleh komunitas melalui reverse engineering. Direkomendasikan untuk kartu grafis lama atau jika ingin menjalankan Wayland compositor.

OpenGL

sudo xbps-install -S mesa-dri

Sudah termasuk dalam meta-paket xorg. Hanya perlu diinstal manual jika menggunakan xorg-minimal atau Wayland compositor.

Vulkan

Didukung mulai arsitektur Kepler (GTX 6xx) ke atas:

sudo xbps-install -S vulkan-loader mesa-vulkan-nouveau

Driver Xorg

Secara default menggunakan xf86-video-nouveau. Pada perangkat ARM berbasis Tegra, gunakan driver modesetting.

Akselerasi Video

VA-API:

sudo xbps-install -S mesa-vaapi
export LIBVA_DRIVER_NAME=nouveau

VDPAU:

sudo xbps-install -S libvdpau-va-gl
export VDPAU_DRIVER=va_gl

Catatan Reclocking (Performa)

Nouveau memiliki keterbatasan dalam mengatur kecepatan clock:

NVIDIA (Driver Proprietary)

Direkomendasikan untuk performa tinggi (gaming/editing). Tersedia di repositori nonfree dan terintegrasi ke kernel melalui DKMS.

Identifikasi Driver yang Tepat

Jalankan perintah berikut untuk mengetahui model GPU:

lspci -k -d ::03xx

Pilih paket driver berdasarkan keluarga GPU:

Dukungan Aplikasi 32-bit (glibc)

Diperlukan untuk menjalankan game lama atau aplikasi seperti Steam.

• Nouveau: instal mesa-dri-32bit.
• NVIDIA: instal nvidia<versi>-libs-32bit (contoh: nvidia470-libs-32bit, atau nvidia-libs-32bit untuk versi terbaru).

Berpindah dari NVIDIA ke Nouveau

Menghapus Driver NVIDIA

sudo xbps-install -S xf86-video-nouveau
sudo xbps-remove nvidia   # Ganti sesuai versi yang terinstal (580, 470, dst.)

Jika menghapus driver lama seperti nvidia340, pastikan untuk menginstal kembali paket libglvnd.

Menyimpan Kedua Driver (Alternatif)

Jika driver NVIDIA ingin tetap terinstal namun Nouveau yang digunakan:

1. Buka file blacklist (/etc/modprobe.d/nouveau_blacklist.conf atau /usr/lib/modprobe.d/nvidia.conf).
2. Beri tanda komentar (#) pada baris blacklist nouveau.
3. Buat file /etc/X11/xorg.conf.d/20-nouveau.conf untuk memaksa Xorg menggunakan Nouveau:

Section "Device"
    Identifier "Nvidia card"
    Driver "nouveau"
EndSection

Restart sistem agar perubahan berlaku.

NVIDIA Optimus

NVIDIA Optimus adalah teknologi grafis ganda pada laptop yang terdiri dari GPU terintegrasi (Intel) dan GPU diskrit (NVIDIA). Pilih metode yang sesuai dengan perangkat keras yang digunakan.

Identifikasi Driver yang Tepat

Dukungan Optimus tidak selalu menjamin versi driver terbaru akan bekerja. Cara terbaik untuk menentukannya:

1. Instal paket nvidia terbaru lalu reboot.
2. Cek log kernel. Jika GPU tidak didukung oleh driver tersebut, akan muncul pesan seperti:

   NVRM: The NVIDIA GPU xxxx:xx:xx.x ... is not supported by the xxx.xx NVIDIA Linux driver release.
   

3. Jika pesan tersebut muncul, hapus driver nvidia dan instal driver legacy nvidia390.

Metode yang Didukung

Metode-metode berikut bersifat eksklusif — pilih salah satu, tidak bisa dijalankan bersamaan:

Konfigurasi

PRIME Render Offload (Disarankan)

Metode ini memungkinkan menjalankan aplikasi tertentu menggunakan GPU NVIDIA melalui variabel lingkungan. Skrip prime-run sudah disertakan dalam paket nvidia:

prime-run <nama_aplikasi>

Contoh: prime-run steam

Bumblebee

1. Aktifkan layanan bumblebeed.
2. Tambahkan user ke grup bumblebee:

sudo usermod -aG bumblebee $USER

3. Log out dan log in kembali.
4. Jalankan aplikasi dengan:

optirun <nama_aplikasi>

Nouveau PRIME

1. Pastikan driver NVIDIA sudah dihapus atau dinonaktifkan.
2. Jalankan aplikasi dengan variabel DRI_PRIME=1:

DRI_PRIME=1 <nama_aplikasi>

Verifikasi GPU yang Aktif

Cek renderer aktif (membutuhkan paket glxinfo):

glxinfo | grep "OpenGL renderer"
# atau jika menggunakan prime-run
prime-run glxinfo | grep "OpenGL renderer"

Cek proses yang menggunakan GPU diskrit (khusus driver NVIDIA):

nvidia-smi

Session (Display Server)

Pilih display server yang akan digunakan sebagai fondasi sesi grafis.

• X11 (Xorg) — Display server klasik, kompatibilitas luas.
• Wayland — Display server modern, keamanan lebih baik.
• XDG Desktop Portal — Komponen layanan sesi grafis.

Xorg

Bagian ini membahas instalasi manual dan konfigurasi Xorg Display Server. Untuk sistem yang langsung siap pakai dengan desktop lengkap, gunakan image XFCE T4n OS.

Instalasi

T4n OS menyediakan dua jalur instalasi untuk Xorg:

• xorg — Paket lengkap: server Xorg, semua driver video gratis, driver input, font, dan aplikasi dasar. Pilihan paling aman untuk sebagian besar pengguna.
• xorg-minimal — Hanya server dasar. Komponen lain harus diinstal manual, seperti font (xorg-fonts), terminal emulator (xterm), dan window manager (i3, openbox).

sudo xbps-install -S xorg

Driver Video

Open-Source

T4n OS mendukung dua kategori driver open-source:

• DDX (xf86-video-*) — Terinstal otomatis bersama paket xorg. Contoh: xf86-video-intel, xf86-video-amdgpu.
• Modesetting — Memerlukan mesa-dri, tidak butuh paket driver spesifik vendor. Xorg akan memprioritaskan DDX jika tersedia; untuk memaksa modesetting, gunakan konfigurasi manual (lihat bagian di bawah).

Proprietary

Tersedia melalui repositori nonfree, khususnya untuk kartu grafis NVIDIA.

Driver Input

Driver input menangani perangkat seperti keyboard, mouse, hingga tombol power, tersedia melalui paket xf86-input-*. Jika perangkat input tidak merespons pada instalasi xorg-minimal, instal driver spesifik seperti xf86-input-evdev atau xf86-input-libinput.

Konfigurasi

Secara umum Xorg mendeteksi perangkat secara otomatis. Konfigurasi manual dapat dilakukan di /etc/X11/xorg.conf.d/.

Konfigurasi Keyboard

Buat file /etc/X11/xorg.conf.d/30-keyboard.conf:

Section "InputClass"
    Identifier "keyboard-all"
    Driver "evdev"
    MatchIsKeyboard "on"
EndSection

Memaksa Driver Modesetting

Buat file /etc/X11/xorg.conf.d/10-modesetting.conf:

Section "Device"
    Identifier "GPU0"
    Driver "modesetting"
EndSection

Verifikasi setelah restart Xorg:

grep -E -m1 '\(II\) modeset\([0-9]+\):' /var/log/Xorg.0.log

Memulai Sesi X

startx

Paket xinit menyediakan skrip startx untuk menjalankan sesi X langsung dari TTY. Konfigurasi melalui file ~/.xinitrc:

# Aplikasi di latar belakang
xscreensaver &

# Window manager — harus baris terakhir dengan exec
exec i3

Jalankan dengan perintah startx.

Display Manager

Display manager menyediakan antarmuka grafis untuk login. Pilihan yang tersedia di T4n OS:

Uji fungsionalitas Xorg dengan startx terlebih dahulu sebelum mengaktifkan display manager secara permanen, untuk menghindari layar hitam saat boot.

Wayland

Wayland adalah protokol display server modern yang menggantikan Xorg. Berbeda dengan Xorg, Wayland menggabungkan fungsi display server, window manager, dan compositor dalam satu aplikasi tunggal.

Lingkungan Desktop

Beberapa desktop environment sudah mendukung sesi Wayland secara bawaan:

• GNOME — Menggunakan sesi Wayland secara default. Aplikasi GTK+ otomatis menggunakan backend Wayland.
• KDE Plasma — Mendukung Wayland; aplikasi Qt mungkin memerlukan konfigurasi tambahan jika dijalankan di luar KDE.
• Enlightenment — Memiliki dukungan sesi Wayland mandiri.

Standalone Compositor

T4n OS menyediakan berbagai pilihan Wayland compositor untuk setup minimalis:

Beberapa compositor tidak menyertakan font secara default. Jika aplikasi tidak tampil atau error, instal paket font seperti fonts-roboto atau ttf-dejavu.

Driver Grafis & Seat Management

Driver Video

• Mesa / Open-source — Sebagian besar compositor membutuhkan driver yang mengimplementasikan antarmuka GBM. Pastikan paket mesa-dri sudah terinstal.
• NVIDIA — GNOME dan KDE Plasma mendukung driver proprietary NVIDIA melalui backend EGLStreams. Compositor lain mungkin memerlukan konfigurasi khusus atau driver versi terbaru yang mendukung GBM.

Seat Management

Wayland memerlukan kontrol atas perangkat input dan tampilan. Aktifkan salah satu layanan berikut:

• elogind
• seatd

Konfigurasi Aplikasi Native Wayland

Agar aplikasi berjalan secara native (bukan melalui emulasi X11), atur variabel lingkungan sesuai toolkit:

Web Browser

• Firefox & Chromium — Mendukung Wayland secara default pada versi terbaru.
• Browser berbasis Qt (qutebrowser) — Berjalan native selama toolkit Qt sudah dikonfigurasi dengan benar.

Menjalankan Aplikasi X11 (XWayland)

Aplikasi yang belum mendukung Wayland secara native tetap bisa dijalankan melalui XWayland — server X yang berjalan sebagai jembatan di dalam sesi Wayland.

Paket: xorg-server-xwayland (biasanya terinstal otomatis sebagai dependensi compositor).

Variabel Lingkungan

Wayland membutuhkan direktori runtime agar soket komunikasinya berfungsi. Variabel berikut biasanya diatur otomatis oleh session manager:

• XDG_RUNTIME_DIR — Menentukan lokasi direktori soket Wayland.
• XDG_SESSION_TYPE — Set ke wayland untuk memberitahu aplikasi bahwa sesi yang berjalan adalah Wayland.

Verifikasi:

echo $XDG_SESSION_TYPE

XDG Desktop Portal

XDG Desktop Portal adalah antarmuka standar yang digunakan oleh aplikasi (terutama Flatpak, Snap, dan aplikasi sandboxed lainnya) untuk berinteraksi dengan sistem host secara aman — termasuk dialog buka/simpan file, clipboard, screencasting, membuka URL, dan lain-lain.

Instalasi

Sistem harus menjalankan D-Bus user session bus sebelum menggunakan XDG Desktop Portal.

Instal paket utama:

sudo xbps-install -S xdg-desktop-portal

Lalu instal setidaknya satu backend yang sesuai dengan desktop environment atau compositor yang digunakan:

Jika ragu, instal xdg-desktop-portal-gtk — kompatibel dengan hampir semua lingkungan desktop.

Konfigurasi

Konfigurasi bawaan di /usr/share/xdg-desktop-portal/portals.conf sudah mencukupi untuk sebagian besar kebutuhan.

Override Konfigurasi

Untuk menyesuaikan portal per DE atau per antarmuka, buat file override di salah satu lokasi berikut:

• Level sistem: /etc/xdg-desktop-portal/portals.conf
• Level pengguna: ~/.config/xdg-desktop-portal/portals.conf atau $XDG_CONFIG_HOME/xdg-desktop-portal/$XDG_CURRENT_DESKTOP-portals.conf

File konfigurasi ini memungkinkan penentuan backend per layanan — misalnya backend KDE untuk file chooser, tapi backend GTK untuk notifikasi. Lihat dokumentasi lengkap:

man 5 portals.conf

Verifikasi

Pastikan portal berjalan setelah instalasi dengan memeriksa proses D-Bus atau mencoba membuka file dialog dari aplikasi Flatpak. Jika menggunakan lingkungan minimal seperti window manager, pastikan dbus-run-session sudah aktif saat memulai sesi desktop.

GUI Core

• XFCE — Desktop environment ringan berbasis X11.
• XFCE Wayland — XFCE dengan dukungan Wayland.

XFCE

T4n OS XFCE menggabungkan efisiensi T4n OS Base dengan lingkungan desktop XFCE4 — dirancang untuk keseimbangan antara performa tinggi dan kemudahan penggunaan grafis.

Komponen Utama

Manajemen Sesi Grafis

T4n OS menggunakan LightDM untuk mengelola login. Pastikan layanan dbus dan lightdm aktif:

sudo ln -s /etc/sv/dbus    /var/service/
sudo ln -s /etc/sv/lightdm /var/service/

File konfigurasi utama: /etc/lightdm/lightdm.conf

Kustomisasi Desktop

XFCE dapat dikonfigurasi melalui Settings Manager (xfce4-settings-manager):

• Appearance — Tema GTK dan ikon.
• Window Manager — Dekorasi jendela dan perilaku fokus.
• Panel — Tambah, hapus, atau atur posisi panel.
• Workspaces — Jumlah desktop virtual.

Manajemen Aplikasi

Selain xbps via terminal, beberapa aplikasi bawaan yang tersedia:

• Web browser: Firefox (atau sesuai image build).
• Editor teks: Mousepad.
• Archiver: File Roller atau Engrampa.

Untuk manajemen paket secara grafis, gunakan octoxbps.

Konfigurasi Perangkat Keras

Display & Monitor

Gunakan aplikasi Display untuk mengatur resolusi dan tata letak multi-monitor. Kecerahan layar pada laptop dikelola oleh xfce4-power-manager.

Audio

T4n OS XFCE menggunakan PipeWire atau PulseAudio. Gunakan plugin xfce4-pulseaudio-plugin di tray untuk kontrol cepat, atau jalankan pavucontrol untuk pengaturan lebih lanjut.

Power Management

Pengaturan baterai, mode tidur, dan aksi tutup layar tersedia di Power Manager.

Integrasi Thunar

• Custom Actions — Klik kanan di dalam folder untuk membuka terminal di lokasi tersebut.
• Volume Management — Automount USB drive (memerlukan layanan gvfs).
• Thumbnail — Pratinjau gambar dan video (memerlukan tumbler).

Troubleshooting

Layar Hitam Setelah Login

1. Masuk ke TTY dengan Ctrl+Alt+F2.
2. Cek apakah partisi penuh: df -h.
3. Pastikan driver GPU sudah terinstal dengan benar sesuai panduan driver T4n OS.

Ikon Tray Tidak Muncul

Pastikan paket xfce4-statusnotifier-plugin terinstal dan sudah ditambahkan ke panel.

Masalah Permission di Thunar

Jika tidak bisa mengakses partisi lain atau USB, pastikan user berada di grup storage:

sudo usermod -aG storage $USER

Perintah Penting

XFCE Wayland

T4n OS XFCE Wayland adalah edisi eksperimental yang menawarkan pengalaman desktop XFCE ringan di atas protokol Wayland — dengan performa visual lebih mulus, keamanan lebih baik, dan dukungan tearing-free secara bawaan.

Arsitektur Sesi

Persyaratan Driver

Wayland membutuhkan driver dengan dukungan GBM (Generic Buffer Management):

• Intel — mesa-dri.
• AMD — mesa-dri dan xf86-video-amdgpu (kernel-mode).
• NVIDIA — Driver versi 470+ (disarankan 525+) dengan nvidia-drm.modeset=1 di kernel cmdline.

Manajemen Sesi & Autostart

Memulai Sesi

T4n OS menggunakan Greetd atau SDDM yang dikonfigurasi untuk Wayland. Untuk menjalankan sesi secara manual dari TTY:

start-xfce-wayland

Variabel Lingkungan

Agar toolkit aplikasi berjalan secara native di Wayland, tambahkan ke /etc/environment atau ~/.bash_profile:

export CLUTTER_BACKEND=wayland
export GDK_BACKEND=wayland,x11
export QT_QPA_PLATFORM=wayland
export MOZ_ENABLE_WAYLAND=1

Komponen Desktop

Beberapa aplikasi standar XFCE diganti dengan alternatif native Wayland untuk stabilitas:

• Panel — xfce4-panel (versi GTK3+) dengan plugin wayland-proxy.
• Wallpaper & Desktop — wpaperd atau swaybg.
• App Launcher — xfce4-appfinder atau wofi.
• Screenshot — grim + slurp (menggantikan xfce4-screenshooter).
• Notifikasi — mako atau xfce4-notifyd (versi terbaru).

Konfigurasi Input & Layar

Input (Mouse & Touchpad)

Pengaturan input dikelola langsung oleh compositor, bukan xf86-input-libinput. Konfigurasi tersedia di ~/.config/labwc/autostart atau melalui tool wlopm.

Display (Output)

Gunakan wlr-randr atau wdisplays untuk mengatur resolusi dan orientasi monitor:

wlr-randr

XWayland

Untuk aplikasi yang belum mendukung Wayland secara native, T4n OS mengaktifkan XWayland secara otomatis.

Verifikasi: jalankan xeyes — jika mata bergerak saat kursor berada di atas jendela aplikasi, aplikasi tersebut berjalan di bawah XWayland.

Troubleshooting

Layar Berkedip (Flickering)

Sering terjadi pada GPU NVIDIA. Tambahkan parameter berikut ke kernel cmdline:

nvidia_drm.modeset=1 nvidia_drm.fbdev=1

Dekorasi Jendela Ganda pada Aplikasi GTK

Paksa dekorasi sisi klien dengan variabel lingkungan:

export GTK_CSD=1

Screencasting Tidak Berfungsi

Pastikan layanan berikut aktif:

1. xdg-desktop-portal
2. xdg-desktop-portal-wlr (atau sesuai compositor)
3. pipewire dan wireplumber

Perintah Penting

GUI Extra

Kustomisasi tampilan sistem.

• Fonts — Instalasi dan konfigurasi font.
• Icons — Paket ikon.
• Themes — Tema GTK dan Qt.

Fonts

Instalasi via XBPS

T4n OS menyediakan berbagai koleksi font melalui XBPS:

sudo xbps-install -S dejavu-fonts-ttf noto-fonts-emoji

Instalasi Manual

Salin file font (.ttf, .otf) ke salah satu direktori berikut:

• Sistem: /usr/share/fonts/ — berlaku untuk semua pengguna.
• Per-pengguna: ~/.local/share/fonts/ — hanya untuk pengguna saat ini.

Perbarui cache font setelah menyalin:

fc-cache -fv

Kustomisasi Tampilan Font

T4n OS menggunakan fontconfig untuk mengatur cara font ditampilkan (aliasing, hinting, dll.). Konfigurasi tersedia di /usr/share/fontconfig/conf.avail/ dan diaktifkan dengan membuat symlink ke /etc/fonts/conf.d/.

Menonaktifkan Bitmap Fonts

Bitmap fonts terkadang terlihat pecah pada layar modern. Untuk menonaktifkannya (kecuali emoji):

sudo ln -s /usr/share/fontconfig/conf.avail/70-no-bitmaps-except-emoji.conf /etc/fonts/conf.d/
sudo xbps-reconfigure -f fontconfig

Verifikasi Konfigurasi

Tampilkan daftar konfigurasi font yang aktif:

fc-conflist

Konfigurasi yang ditandai + berarti sedang aktif.

Icons

Ikon Bawaan (GTK)

Secara default, aplikasi berbasis GTK menggunakan tema ikon Adwaita, yang terinstal otomatis sebagai dependensi saat menginstal gtk+3.

Tema Ikon Kustom

Instalasi

Instal tema ikon pilihan via XBPS:

sudo xbps-install -S papirus-icon-theme

Konfigurasi

Tentukan nama tema di file konfigurasi GTK:

• Per-pengguna: ~/.config/gtk-3.0/settings.ini
• Sistem: /etc/gtk-3.0/settings.ini

Tambahkan atau ubah baris berikut di bagian [Settings]:

[Settings]
gtk-icon-theme-name = nama-tema-ikon

Ganti nama-tema-ikon dengan nama folder tema yang terinstal di /usr/share/icons/.

Menghapus Tema Adwaita

adwaita-icon-theme adalah dependensi wajib GTK. Untuk menghapusnya:

1. Tambahkan adwaita-icon-theme ke daftar ignorepkg di konfigurasi XBPS.
2. Hapus paket secara manual:

sudo xbps-remove -F adwaita-icon-theme

Lokasi File Ikon

Themes

Lokasi Penyimpanan Tema

Tema GTK (XFCE, GNOME, dll.)

Instalasi via XBPS

sudo xbps-install -S arc-theme adwaita-icon-theme greybird-themes

Konfigurasi Manual

Untuk setup headless atau tanpa DE, edit ~/.config/gtk-3.0/settings.ini:

[Settings]
gtk-theme-name = Arc-Dark
gtk-icon-theme-name = Papirus-Dark
gtk-font-name = DejaVu Sans 11
gtk-cursor-theme-name = Adwaita

Kustomisasi via XFCE

• Settings > Appearance — Tema widget dan ikon.
• Settings > Window Manager — Tema dekorasi jendela.

Tema Qt (KDE, LXQt)

Agar aplikasi Qt tampil selaras dengan lingkungan GTK:

1. Instal qt5ct atau qt6ct:

sudo xbps-install -S qt5ct qt6ct

2. Tambahkan variabel lingkungan ke ~/.bash_profile atau /etc/environment:

export QT_QPA_PLATFORMTHEME=qt5ct

3. Buka aplikasi Qt5 Settings untuk memilih tema.

Tema Kursor

Kursor disimpan di /usr/share/icons/ atau ~/.icons/. Untuk mengubah kursor secara manual, buat atau edit ~/.icons/default/index.theme:

[Icon Theme]
Inherits=Nama-Tema-Kursor

Tema Terminal

• XFCE Terminal — Edit > Preferences > Colors.
• Alacritty / Kitty — Edit file konfigurasi di ~/.config/.

Dark Mode

Paksa skema warna gelap secara global dengan variabel lingkungan di ~/.profile:

export GTK_THEME=Arc-Dark

Tema dari Komunitas

Tema buatan komunitas dapat diunduh dari:

• gnome-look.org — GTK
• store.kde.org — Qt / KDE
• xfce-look.org — XFCE

Cara pasang:

1. Ekstrak file .tar.gz.
2. Pindahkan folder hasil ekstrak ke ~/.local/share/themes/.
3. Pilih tema melalui pengaturan sistem.

CLI — Command Line

• Server (Coming Soon)
• Penjelasan Singkat

Server

Dokumentasi ini mencakup penggunaan T4n OS dan Void Linux sebagai sistem operasi server — mulai dari manajemen layanan, konfigurasi jaringan, hingga keamanan sistem.

Konsep Dasar

T4n OS menggunakan runit sebagai init system dan supervision suite. Berbeda dengan systemd, runit bersifat minimalis dan deterministik — setiap layanan dijalankan sebagai proses independen dengan environment yang bersih.

Untuk kebutuhan server, pendekatan ini memberikan beberapa keuntungan:

• Layanan yang gagal di-restart secara otomatis oleh supervisor.
• Tidak ada dependency hell antar layanan — setiap service berdiri sendiri.
• Log per-layanan dikelola oleh svlogd, terpisah dari log sistem.
• Startup time lebih cepat karena tidak ada unit orchestration yang kompleks.

Manajemen Layanan Server

Layanan server diaktifkan dengan membuat symlink ke /var/service/:

# Aktifkan layanan
ln -s /etc/sv/<layanan> /var/service/

# Cek status
sv status <layanan>

# Restart layanan
sv restart <layanan>

# Cek Status Semua Layanan Aktif
sv status /var/service/*

Contoh layanan umum untuk server:

Logging

T4n OS tidak menginstal syslog daemon secara default. Untuk server, disarankan menggunakan socklog:

sudo xbps-install -S socklog-void
ln -s /etc/sv/socklog-unix /var/service/
ln -s /etc/sv/nanoklogd    /var/service/

Log tersimpan di /var/log/socklog/ dan dapat dibaca dengan svlogtail.

Firewall

Untuk mengamankan server, aktifkan firewall dengan nftables atau iptables. Lihat dokumentasi Firewall untuk panduan lengkap.

Keamanan Dasar

Beberapa langkah keamanan yang disarankan untuk setup server:

• Nonaktifkan login root via SSH — edit /etc/ssh/sshd_config dan set PermitRootLogin no.
• Gunakan key-based authentication, bukan password.
• Aktifkan firewall dengan nftables atau iptables.
• Pasang AppArmor untuk mandatory access control pada layanan kritis.
• Pantau log secara berkala via socklog atau rsyslog.

Dokumentasi Lengkap

Server

Multimedia

Pengaturan Audio

T4n OS mendukung beberapa pilihan sistem audio. Pilih salah satu sesuai kebutuhan:

Jika elogind tidak aktif, pastikan user tergabung di grup audio agar dapat mengakses perangkat audio.

• ALSA
• PipeWire
• PulseAudio

ALSA

ALSA (Advanced Linux Sound Architecture) menyediakan fungsionalitas audio dasar pada tingkat kernel.

Instalasi

sudo xbps-install -S alsa-utils

Tambahkan user ke grup audio untuk akses ke perangkat keras:

sudo usermod -aG audio $USER

Aktifkan layanan alsa untuk menyimpan dan memulihkan status volume saat boot:

sudo ln -s /etc/sv/alsa /var/service/

Kompatibilitas PulseAudio via apulse

Beberapa aplikasi mewajibkan PulseAudio. Gunakan apulse sebagai lapisan kompatibilitas yang menerjemahkan instruksi PulseAudio langsung ke ALSA:

sudo xbps-install -S apulse

Jalankan aplikasi dengan awalan apulse:

apulse firefox

Konfigurasi Kartu Suara Default

Identifikasi Kartu Suara

cat /proc/asound/modules

Contoh output:

0 snd_hda_intel
1 snd_hda_intel
2 snd_usb_audio

Metode A — Konfigurasi ALSA

Edit /etc/asound.conf (sistem) atau ~/.asoundrc (per-pengguna). Contoh untuk menjadikan kartu nomor 2 sebagai default:

defaults.ctl.card 2;
defaults.pcm.card 2;

Metode B — Modul Kernel

Atur urutan indeks kartu suara di /etc/modprobe.d/alsa.conf. Contoh agar audio USB selalu menjadi indeks pertama:

options snd_usb_audio index=0

Multi-Sumber (Dmix)

Plugin dmix memungkinkan ALSA memutar suara dari beberapa aplikasi secara bersamaan. Secara default aktif otomatis jika kartu suara tidak mendukung hardware mixing.

Untuk mengaktifkannya secara eksplisit, tambahkan ke /etc/asound.conf:

pcm.dsp {
    type plug
    slave.pcm "dmix"
}

Tips

• alsamixer — mixer volume berbasis terminal, tekan F6 untuk memilih kartu suara lain.
• sudo alsactl store — simpan pengaturan volume saat ini secara manual.

PipeWire

PipeWire adalah server modern untuk menangani aliran audio dan video. PipeWire dapat terhubung dengan aplikasi yang dirancang untuk ALSA, PulseAudio, dan JACK — serta mendukung Flatpak dan screensharing di Wayland melalui xdg-desktop-portal.

Persiapan

Sebelum mengaktifkan PipeWire, pastikan hal berikut terpenuhi:

• D-Bus user session harus aktif. Jika DE atau window manager belum menyediakannya, jalankan sesi dengan dbus-run-session.
• XDG_RUNTIME_DIR harus terdefinisi agar PipeWire berfungsi dengan benar.
• Jika tidak menggunakan elogind, tambahkan user ke grup audio dan video:

sudo usermod -aG audio,video $USER

Instalasi

sudo xbps-install -S pipewire

Paket ini juga menginstal WirePlumber sebagai manajer sesi bawaan.

Konfigurasi WirePlumber

PipeWire tidak berfungsi tanpa manajer sesi. Aktifkan WirePlumber secara otomatis:

Global (sistem):

sudo mkdir -p /etc/pipewire/pipewire.conf.d
sudo ln -s /usr/share/examples/wireplumber/10-wireplumber.conf /etc/pipewire/pipewire.conf.d/

Per-pengguna:

mkdir -p ~/.config/pipewire/pipewire.conf.d
ln -s /usr/share/examples/wireplumber/10-wireplumber.conf ~/.config/pipewire/pipewire.conf.d/

Antarmuka PulseAudio

Banyak aplikasi membutuhkan antarmuka PulseAudio. Hapus paket pulseaudio jika masih terinstal, lalu aktifkan emulator PulseAudio di PipeWire:

Global (sistem):

sudo ln -s /usr/share/examples/pipewire/20-pipewire-pulse.conf /etc/pipewire/pipewire.conf.d/

Per-pengguna:

ln -s /usr/share/examples/pipewire/20-pipewire-pulse.conf ~/.config/pipewire/pipewire.conf.d/

Pengujian

Jalankan PipeWire secara manual untuk memastikan tidak ada error:

pipewire

Cek status WirePlumber:

wpctl status

Jika antarmuka PulseAudio aktif, verifikasi dengan:

pactl info
# Harus muncul: Server Name: PulseAudio (on PipeWire 0.x.x)

Autostart

Setelah dipastikan bekerja, aktifkan PipeWire saat login dengan salah satu cara berikut:

• Desktop Environment — Tambahkan pipewire ke daftar Startup Applications.
• XDG Autostart — Buat symlink ke folder autostart:

ln -s /usr/share/applications/pipewire.desktop ~/.config/autostart/

• Window Manager — Tambahkan pipewire & ke ~/.xinitrc atau script startup WM.

Fitur Opsional

Troubleshooting

Error Umum

Integrasi ALSA Gagal

Jika aplikasi ALSA tidak mengeluarkan suara melalui PipeWire:

sudo mkdir -p /etc/alsa/conf.d
sudo ln -s /usr/share/alsa/alsa.conf.d/50-pipewire.conf         /etc/alsa/conf.d
sudo ln -s /usr/share/alsa/alsa.conf.d/99-pipewire-default.conf /etc/alsa/conf.d

PulseAudio

PulseAudio adalah server suara yang berfungsi sebagai perantara antara aplikasi dan perangkat keras audio. Meskipun PipeWire direkomendasikan untuk sistem modern, PulseAudio tetap menjadi pilihan yang stabil untuk kebutuhan audio tradisional.

Persiapan

Agar PulseAudio dapat mengakses perangkat keras audio, pilih salah satu:

• Grup Audio (manual) — Tambahkan user ke grup audio:

sudo usermod -aG audio $USER

• Session Manager (otomatis) — Gunakan elogind yang mengatur izin akses secara otomatis saat login.

D-Bus

Tergantung aplikasi yang digunakan, PulseAudio mungkin memerlukan D-Bus sistem atau sesi:

• D-Bus sistem — Pastikan layanan dbus sudah aktif.
• D-Bus sesi — Jika DE tidak menyediakannya, jalankan sesi dengan dbus-run-session.

Kompatibilitas ALSA

Untuk aplikasi lama yang hanya mendukung ALSA secara langsung, instal:

sudo xbps-install -S alsa-plugins-pulseaudio

Paket ini memungkinkan aplikasi ALSA mengalirkan audio melalui PulseAudio.

Manajemen Layanan

Menjalankan PulseAudio

Secara default PulseAudio berjalan otomatis saat dibutuhkan. Untuk menjalankan secara manual:

pulseaudio --daemonize=no --exit-idle-time=-1

Menonaktifkan Auto-Activation

Untuk mencegah PulseAudio aktif otomatis (misalnya saat menggunakan PipeWire atau ALSA murni), edit /etc/pulse/client.conf atau ~/.config/pulse/client.conf:

autospawn = no

Utilitas

Bluetooth

Persiapan

Sebelum menggunakan Bluetooth, pastikan controller tidak terblokir:

rfkill

Contoh output:

ID TYPE      DEVICE    SOFT      HARD
0  wlan      phy0      unblocked unblocked
1  bluetooth hci0      blocked   unblocked

Jika status SOFT menunjukkan blocked, buka blokir secara software:

sudo rfkill unblock bluetooth

Jika HARD menunjukkan blocked, kemungkinan ada saklar fisik di laptop atau opsi di BIOS yang perlu diaktifkan terlebih dahulu.

Instalasi

sudo xbps-install -S bluez
ln -s /etc/sv/dbus /var/service/
ln -s /etc/sv/bluetoothd /var/service/

Tambahkan pengguna ke grup bluetooth:

sudo usermod -aG bluetooth <nama_user>

Lalu reboot agar perubahan grup diterapkan.

Merestart layanan dbus dapat mematikan proses yang sedang menggunakannya — reboot lebih aman.

Dukungan Audio Bluetooth

Untuk menggunakan perangkat audio Bluetooth (speaker, headset, dll.):

# Contoh untuk PipeWire
sudo xbps-install -S libspa-bluetooth

Penggunaan

Kelola koneksi dan controller Bluetooth menggunakan bluetoothctl:

bluetoothctl

Contoh Pairing Perangkat

> power on
> agent on
> default-agent
> scan on
> pair XX:XX:XX:XX:XX:XX
> connect XX:XX:XX:XX:XX:XX
> trust XX:XX:XX:XX:XX:XX
> scan off
> exit

Ganti XX:XX:XX:XX:XX:XX dengan MAC address perangkat yang muncul saat scan on.

Konfigurasi

File konfigurasi utama: /etc/bluetooth/main.conf

Beberapa opsi yang umum diubah:

[Policy]
# Otomatis menyambung kembali ke perangkat yang dipercaya saat boot
AutoEnable=true

[General]
# Ubah nama controller Bluetooth
Name=T4nOS

TeX Live

T4n OS menyediakan dua cara untuk menginstal TeX Live:

⚠️ Penting: Paket TeX yang diinstal via xbps dan via tlmgr tidak bisa saling berinteraksi. Pilih salah satu metode dan gunakan secara konsisten.

Contoh: pdflatex dari paket texlive-pdflatex (xbps) tidak bisa digunakan untuk mengkompilasi dokumen yang menggunakan paket yang diinstal via tlmgr. Solusinya adalah menjalankan tlmgr install pdflatex untuk mendapatkan versi yang kompatibel.

Instalasi

Metode tlmgr (Disarankan)

sudo xbps-install -S texlive-bin

Instal gnupg untuk verifikasi paket TeX:

sudo xbps-install -S gnupg

Metode XBPS

sudo xbps-install -S texlive

Konfigurasi Awal (tlmgr)

Setelah instalasi, perbarui variabel PATH:

source /etc/profile

Verifikasi bahwa direktori TeX Live sudah masuk ke PATH:

echo $PATH
# Pastikan ada path seperti: /opt/texlive/<tahun>/bin/x86_64-linux

Atur ukuran kertas default jika diperlukan:

sudo tlmgr paper a4      # Ukuran A4
sudo tlmgr paper letter  # Ukuran Letter (US)

Manajemen Paket (tlmgr)

Instal Semua Paket

sudo tlmgr install scheme-full

Instal Koleksi Paket

Lihat daftar koleksi yang tersedia:

tlmgr info collections

Lihat isi file dalam koleksi tertentu:

tlmgr info --list collection-<nama>

Instal koleksi:

sudo tlmgr install collection-<nama>

Instal Paket Tunggal

Cari paket terlebih dahulu:

tlmgr search --global <nama-paket>

Instal paket:

sudo tlmgr install <nama-paket>

Cari Paket Berdasarkan File

Berguna untuk mencari paket yang menyediakan font atau file tertentu:

tlmgr search --file <nama-file> --global

Hapus Paket

sudo tlmgr remove <nama-paket>

Update Semua Paket

sudo tlmgr update --all

Referensi

Dokumentasi lengkap tlmgr tersedia di tug.org/texlive/doc/tlmgr.html.

Aplikasi Eksternal

Bahasa Pemrograman

T4n OS menyediakan sejumlah paket Python dan Lua di repositori. Sebisa mungkin, gunakan paket dari repositori T4n OS terlebih dahulu sebelum menggunakan package manager bahasa (pip, gem, dll.).

Jika menginstal library via package manager bahasa atau mengkompilasi dari source, kemungkinan perlu menginstal paket -devel yang sesuai. Hal ini terutama berlaku untuk pengguna musl libc, karena binary pre-built biasanya ditargetkan untuk glibc.

Java

T4n OS menyediakan versi LTS dari OpenJDK. Versi yang tersedia: 8, 11, 17, dan 21.

Ganti X dengan versi yang diinginkan, contoh openjdk21.

Beberapa Versi Java Bersamaan

T4n OS menggunakan xbps-alternatives untuk mengelola beberapa versi Java secara paralel. Symlink dikelola di:

• /usr/lib/jvm/default-jdk
• /usr/lib/jvm/default-jre

Untuk mengganti versi Java aktif:

sudo xbps-alternatives -s openjdk21

Setelah menginstal Java untuk pertama kali, perbarui variabel lingkungan:

source /etc/profile.d/jdk.sh

Atau login ulang ke sesi terminal.

Paket Terbatas (Restricted Packages)

Beberapa paket tidak dapat didistribusikan oleh T4n OS karena alasan lisensi, ukuran, atau kondisi lainnya (contoh: Discord). Paket-paket ini memiliki template build, namun harus dibangun secara lokal.

• Void-Packages · srcpkgs/
• VUR - Void User Repository atau VUR-Web

Arsitektur Non-x86_64

Beberapa paket tidak mendukung cross-compilation (contoh: pandoc) dan harus dibangun secara lokal di komputer dengan arsitektur dan libc yang sama dengan sistem target. Lihat README repositori void-packages untuk panduan build paket.

Flatpak

Flatpak adalah metode lain untuk menginstal aplikasi berpemilik eksternal pada Linux. Untuk informasi tentang penggunaan Flatpak dengan T4n OS (Based on Void Linux), lihat situs resminya. Dokumentasi Flatpak .

Troubleshooting Flatpak

Audio tidak berfungsi: Pastikan PulseAudio sudah berjalan sebelum meluncurkan aplikasi Flatpak. Auto-aktivasi PulseAudio mungkin tidak bekerja dengan benar. Pastikan PulseAudio berjalan sebelum meluncurkan program.

Aplikasi tidak bisa mengakses file sistem: Instal paket berikut sesuai kebutuhan:

sudo xbps-install -S xdg-user-dirs xdg-user-dirs-gtk xdg-utils

Lalu konfigurasi XDG Desktop Portals.

Beberapa Flatpak juga membutuhkan D-Bus dan/atau PulseAudio untuk berjalan.

Catatan: Sandboxing Flatpak tidak menjamin perlindungan dari fitur yang melanggar privasi atau keamanan dalam perangkat lunak proprietary.

AppImage

AppImage adalah format paket yang menyertakan aplikasi beserta semua dependensinya dalam satu file. Tidak perlu instalasi — cukup jadikan executable dan jalankan:

chmod +x namaaplikasi.AppImage
./namaaplikasi.AppImage

Untuk keamanan tambahan, AppImage dapat dijalankan dalam sandbox menggunakan firejail:

sudo xbps-install -S firejail
firejail ./namaaplikasi.AppImage

Daftar aplikasi yang tersedia dalam format AppImage dapat ditemukan di AppImageHub.

Catatan: AppImage belum berfungsi pada instalasi musl.

Paket Octave

Beberapa paket Octave membutuhkan dependensi eksternal. Contoh untuk membangun paket control:

sudo xbps-install -S openblas-devel libgomp-devel libgfortran-devel gcc-fortran gcc

MATLAB

Untuk menggunakan fitur berikut di MATLAB:

• Help browser
• Live scripts
• Add-on installer
• Simulink

Instal paket libselinux:

sudo xbps-install -S libselinux

Steam

Steam dapat diinstal dengan dua cara:

Menyimpan Library Game di Drive Lain (Flatpak)

Gunakan flatpak override untuk memberikan akses ke drive lain:

flatpak override --user --filesystem=/path/ke/drive com.valvesoftware.Steam

Mencetak (Printing)

T4n OS menggunakan CUPS (Common Unix Printing System) sebagai sistem pencetakan.

Instalasi CUPS

sudo xbps-install -S cups
ln -s /etc/sv/cupsd /var/service/

Tunggu hingga layanan cupsd aktif sebelum melanjutkan.

Driver Printer

Driverless Printing (Jaringan Modern)

Sebagian besar printer jaringan modern mendukung standar IPP Everywhere — tidak memerlukan driver tambahan. Lihat daftar printer yang bersertifikat di pwg.org/printers.

cups-filters tetap diperlukan meskipun menggunakan driverless printing.

sudo xbps-install -S cups-filters

Driver per Merek

Instalasi Driver HP

sudo xbps-install -S hplip
sudo hp-setup -i

Ikuti panduan interaktif — pilihan default biasanya sudah mencukupi.

Instalasi Driver Brother

sudo xbps-install -S foomatic-db foomatic-db-nonfree brother-brlaser

Instalasi Driver Epson

sudo xbps-install -S epson-inkjet-printer-escpr

Instalasi Driver Canon PIXMA/MAXIFY

Aktifkan repositori nonfree terlebih dahulu, lalu:

sudo xbps-install -S cnijfilter2

Menambahkan Printer

Otomatis (ZeroConf / IPP Everywhere)

Printer dengan dukungan IPP Everywhere dapat ditemukan dan dikonfigurasi secara otomatis:

sudo xbps-install -S avahi nss-mdns
ln -s /etc/sv/avahi-daemon /var/service/

Via Web Interface

1. Buka browser dan akses: http://localhost:631
2. Buka tab Administration → Printers → Add Printer
3. Login menggunakan akun yang tergabung di grup lpadmin:

sudo usermod -aG lpadmin <nama_user>

Via GUI (system-config-printer)

sudo xbps-install -S system-config-printer
sudo system-config-printer

Untuk mengizinkan pengguna biasa menjalankannya tanpa root, instal cups-pk-helper:

sudo xbps-install -S cups-pk-helper

Desktop environment kamu mungkin sudah memiliki dialog printer bawaan — cek dokumentasi DE masing-masing.

Via Command Line

lpadmin -p <nama_printer> -E -v <device_uri> -m <driver>

Troubleshooting

Printer USB Tidak Terdeteksi

Temukan URI device secara manual:

sudo /usr/lib/cups/backend/usb

Gunakan URI yang muncul saat menambahkan printer secara manual melalui web interface atau lpadmin.

Container & Virtual Machine

Bagian ini menjelaskan cara mengatur perangkat lunak container dan virtual machine yang tersedia di T4n OS.

Daftar Isi

• Chroot & Container
• Libvirt
• LXC
• KVM
• QEMU
• VMware
• VirtualBox
• Waydroid

Chroot & Container

Chroot dan container dapat digunakan untuk berbagai tujuan, antara lain:

• Menjalankan perangkat lunak berbasis glibc di sistem musl (atau sebaliknya).
• Menjalankan aplikasi dalam lingkungan yang lebih terkontrol atau terisolasi.
• Membuat rootfs untuk proses instalasi sistem baru (bootstrapping).

Pembuatan Chroot

Menggunakan xvoidstrap (Disarankan)

Cara termudah menggunakan xvoidstrap dari paket xtools:

1. Buat direktori tujuan:

sudo mkdir <direktori_chroot>

2. Instal sistem dasar:

sudo XBPS_ARCH=<arsitektur> xvoidstrap <direktori_chroot> base-container <paket_lainnya>

<paket_lainnya> bersifat opsional jika ingin menginstal paket tambahan sejak awal.

Manual via xbps-install

1. Siapkan kunci repositori:

sudo mkdir -p "<direktori_chroot>/var/db/xbps/keys"
sudo cp -a /var/db/xbps/keys/* "<direktori_chroot>/var/db/xbps/keys"

2. Instal paket base-container:

sudo XBPS_ARCH=<arsitektur> xbps-install -S -r <direktori_chroot> -R <url_repository> base-container

Penggunaan Chroot

Menggunakan xchroot

Gunakan xchroot (dari xtools) untuk masuk ke chroot secara otomatis tanpa mounting manual:

sudo xchroot <direktori_chroot>

Manual

1. Salin konfigurasi jaringan (opsional):

sudo cp /etc/resolv.conf <direktori_chroot>/etc/

2. Mount direktori sistem:

sudo mount -t proc  none <direktori_chroot>/proc
sudo mount -t sysfs none <direktori_chroot>/sys
sudo mount --rbind  /dev <direktori_chroot>/dev
sudo mount --rbind  /run <direktori_chroot>/run

3. Masuk ke chroot:

sudo chroot <direktori_chroot> /bin/bash

Selalu lakukan umount setelah selesai. Menghapus direktori chroot tanpa unmount terlebih dahulu dapat merusak sistem host.

Alternatif Lain

Bubblewrap (Sandboxing)

bwrap dari paket bubblewrap memungkinkan isolasi yang lebih kuat dan tidak membutuhkan akses root:

bwrap --bind <direktori_chroot> / \
      --dev /dev --proc /proc \
      --bind /sys /sys --bind /run /run \
      --ro-bind /etc/resolv.conf /etc/resolv.conf \
      sh

Flatpak

Solusi praktis untuk menjalankan aplikasi grafis atau proprietary lintas pustaka (glibc/musl) secara aman dan terisolasi.

Docker / Podman

T4n OS menyediakan image OCI resmi yang dapat digunakan dengan docker atau podman — solusi yang lebih matang tanpa perlu membuat direktori chroot secara manual.

libvirt

libvirt adalah API dan daemon untuk mengelola platform virtualisasi. Mendukung berbagai teknologi seperti KVM, QEMU, LXC, Bhyve, Xen, VMware, hingga Hyper-V.

Instalasi

sudo xbps-install -S libvirt dbus

Jika menggunakan QEMU/KVM, pastikan paket qemu juga terinstal.

Aktifkan layanan yang diperlukan:

sudo ln -s /etc/sv/dbus       /var/service/
sudo ln -s /etc/sv/libvirtd   /var/service/
sudo ln -s /etc/sv/virtlockd  /var/service/
sudo ln -s /etc/sv/virtlogd   /var/service/

Akses Non-Root

Secara default, perintah manajemen virtualisasi memerlukan akses root. Untuk menjalankan sebagai pengguna biasa:

1. Pastikan paket polkit dan dbus terinstal serta layanan dbus aktif.
2. Tambahkan user ke grup libvirt:

sudo usermod -aG libvirt $USER

Log out dan log in kembali agar perubahan grup diterapkan.

Antarmuka Manajemen

CLI — virsh

Paket libvirt menyertakan virsh, shell interaktif untuk membuat, mengonfigurasi, dan menjalankan VM serta mengelola jaringan dan penyimpanan:

virsh list --all

Untuk mengonfigurasi daemon libvirtd secara langsung, gunakan virt-admin.

GUI — virt-manager

sudo xbps-install -S virt-manager virt-manager-tools

virt-manager menyediakan antarmuka grafis untuk memantau statistik VM dan mengakses konsol sistem tamu.

Referensi

• Libvirt Wiki — Dokumentasi teknis dan informasi umum.
• man virsh — Manual CLI virsh.
• man libvirtd — Manual daemon libvirt.

LXC (Linux Containers)

Proyek Linux Containers mencakup empat subproyek utama:

Catatan: CGManager sudah deprecated (digantikan oleh CGroup namespace di kernel modern). LXD kini menjadi proyek Canonical — Incus hadir sebagai alternatif berbasis komunitas.

Container Unprivileged

Container unprivileged meningkatkan keamanan dengan memetakan UID/GID di dalam container ke range yang tidak digunakan oleh host.

Delegasi UID/GID Subordinat

Edit /etc/subuid dan /etc/subgid untuk mendelegasikan range:

root:1000000:65536
user:2000000:65536

Format setiap baris: <user>:<id_awal>:<jumlah_id>

Jumlah ID sebaiknya kelipatan 65536. Pastikan range antar pengguna tidak saling tumpang tindih.

Mengonfigurasi LXC

sudo xbps-install -S lxc

Container privileged (sebagai root) tidak memerlukan konfigurasi tambahan — langsung gunakan perintah lxc-*.

File Konfigurasi Mapping ID

Sebelum membuat container, tentukan mapping UID/GID di file lxc.conf:

Tambahkan mapping berikut:

lxc.idmap = u 0 1000000 65536
lxc.idmap = g 0 1000000 65536

Konfigurasi Jaringan (User Non-Root)

Edit /etc/lxc/lxc-usernet sebagai root untuk mengizinkan user membuat perangkat jaringan virtual:

user veth lxcbr0 10

Baris ini mengizinkan user membuat hingga 10 perangkat veth yang terhubung ke bridge lxcbr0.

Membuat Container

lxc-create -n mycontainer -t download -- \
    --dist voidlinux --release current --arch amd64

Untuk image musl, tambahkan --variant musl. Lihat LXC Image Server untuk daftar container yang tersedia.

Lokasi Penyimpanan Container

Nilai ini dapat diubah via lxc.lxcpath di lxc.system.conf.

Tips keamanan: Secara default, semua container berbagi mapping UID/GID yang sama. Untuk mengisolasi container satu sama lain, ubah lxc.idmap ke range unik sebelum membuat setiap container.

Incus (Alternatif yang Disarankan)

Incus menyediakan antarmuka yang lebih modern untuk mengelola container dan virtual machine, tanpa konfigurasi manual seperti di atas.

Instalasi

Set CGROUP_MODE di /etc/rc.conf:

CGROUP_MODE=unified

Instal dan aktifkan Incus:

sudo xbps-install -S incus
ln -s /etc/sv/incus /var/service/

Akses Pengguna

# Akses penuh
sudo usermod -aG _incus-admin <nama_user>

# Akses terbatas
sudo usermod -aG _incus <nama_user>
ln -s /etc/sv/incus-user /var/service/

⚠️ incus-user akan menginisialisasi profil default Incus saat pertama kali dijalankan. Jika ingin mengontrol inisialisasi sendiri, jalankan incus admin init sebelum mengaktifkan incus-user.

incus-user juga dapat menggantikan konfigurasi jaringan profil default jika dianggap tidak valid — ini terjadi saat boot, bukan saat user memanggil Incus.

Dependensi Tambahan

sudo xbps-install -S qemu edk2-ovmf   # Untuk menjalankan virtual machine
sudo xbps-install -S skopeo            # Untuk menjalankan OCI container

Migrasi dari LXD / LXC

sudo xbps-install -S incus-tools

# Migrasi dari LXD
lxd-to-incus

# Migrasi dari LXC
lxc-to-incus

LXD

LXD adalah alternatif antarmuka LXC yang kini dikelola oleh Canonical.

sudo xbps-install -S lxd
ln -s /etc/sv/lxd /var/service/
sudo usermod -aG lxd <nama_user>

Gunakan perintah lxc untuk mengelola instance LXD.

KVM (Kernel-based Virtual Machine)

KVM adalah solusi virtualisasi berbasis kernel Linux yang memungkinkan menjalankan virtual machine (VM) dengan performa mendekati native. KVM bekerja dengan mengubah Linux menjadi hypervisor tipe-1.

Persyaratan

Pastikan prosesor mendukung virtualisasi hardware:

# Intel
grep -c vmx /proc/cpuinfo

# AMD
grep -c svm /proc/cpuinfo

Jika output bernilai lebih dari 0, prosesor mendukung virtualisasi. Pastikan fitur ini juga sudah diaktifkan di BIOS/UEFI.

Cek apakah modul KVM sudah dimuat:

lsmod | grep kvm

Instalasi

Paket Utama

sudo xbps-install -S qemu

QEMU adalah emulator dan virtualizer yang bekerja bersama KVM untuk menjalankan VM dengan akselerasi hardware.

Paket Tambahan (Opsional)

sudo xbps-install -S libvirt virt-manager virt-viewer edk2-ovmf

Konfigurasi

Tambahkan Pengguna ke Grup yang Diperlukan

sudo usermod -aG kvm <nama_user>
sudo usermod -aG libvirt <nama_user>   # Jika menggunakan libvirt

Login ulang agar perubahan grup diterapkan.

Aktifkan Layanan libvirt

ln -s /etc/sv/libvirtd /var/service/
ln -s /etc/sv/virtlogd /var/service/

Konfigurasi Jaringan (NAT)

libvirt secara default membuat jaringan NAT (virbr0) untuk VM. Aktifkan dan set agar otomatis start:

sudo virsh net-start default
sudo virsh net-autostart default

Konfigurasi Jaringan (Bridge)

Untuk VM yang bisa diakses di jaringan lokal seperti host, buat bridge interface. Tambahkan ke /etc/rc.local:

ip link add name br0 type bridge
ip link set eth0 master br0
ip link set eth0 up
ip link set br0 up

Membuat dan Menjalankan VM

Via QEMU Langsung (CLI)

Buat disk image untuk VM:

qemu-img create -f qcow2 vm-disk.qcow2 20G

Jalankan VM dengan akselerasi KVM:

qemu-system-x86_64 \
    -enable-kvm \
    -m 2G \
    -smp 2 \
    -drive file=vm-disk.qcow2,format=qcow2 \
    -cdrom /path/ke/installer.iso \
    -boot d \
    -net nic \
    -net user

Penjelasan opsi umum:

Via virt-manager (GUI)

Jalankan virt-manager dan ikuti wizard untuk membuat VM baru. virt-manager menyediakan antarmuka grafis untuk seluruh siklus hidup VM.

Via virsh (CLI libvirt)

# Lihat daftar VM
virsh list --all

# Jalankan VM
virsh start <nama_vm>

# Hentikan VM
virsh shutdown <nama_vm>

# Matikan paksa
virsh destroy <nama_vm>

# Hapus VM
virsh undefine <nama_vm> --remove-all-storage

VM dengan UEFI

Untuk VM yang membutuhkan firmware UEFI (contoh: Windows 11, distro modern):

Salin file VARS terlebih dahulu agar bisa ditulis per-VM:

cp /usr/share/edk2-ovmf/x64/OVMF_VARS.fd ./OVMF_VARS.fd

Jalankan VM:

qemu-system-x86_64 \
    -enable-kvm \
    -m 4G \
    -smp 4 \
    -drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2-ovmf/x64/OVMF_CODE.fd \
    -drive if=pflash,format=raw,file=OVMF_VARS.fd \
    -drive file=vm-disk.qcow2,format=qcow2

Berbagi File antara Host dan VM

Metode 9P (VirtFS)

Tambahkan opsi berikut ke perintah QEMU:

-fsdev local,security_model=passthrough,id=fsdev0,path=/path/di/host \
-device virtio-9p-pci,id=fs0,fsdev=fsdev0,mount_tag=hostshare

Mount di dalam VM:

mount -t 9p -o trans=virtio hostshare /mnt/shared

Troubleshooting

KVM Permission Denied

ls -l /dev/kvm
# Output: crw-rw---- 1 root kvm ...

# Pastikan user sudah di grup kvm
groups <nama_user>

VM Lambat / Tidak Ada Akselerasi

Verifikasi KVM aktif di dalam VM:

cat /proc/cpuinfo | grep hypervisor

Pastikan perintah QEMU menggunakan -enable-kvm dan CPU virtual dengan model yang tepat:

-cpu host   # Gunakan CPU host secara langsung (performa terbaik)

libvirtd Gagal Start

Periksa log:

cat /var/log/libvirt/libvirtd.log

Pastikan modul kernel sudah dimuat:

sudo modprobe kvm
sudo modprobe kvm_intel   # Intel
# atau
sudo modprobe kvm_amd     # AMD

QEMU

QEMU (Quick Emulator) adalah emulator dan virtualizer open-source yang mampu menjalankan sistem operasi dan program untuk berbagai arsitektur. QEMU dapat berjalan dalam dua mode:

Dikombinasikan dengan KVM, QEMU dapat menjalankan VM dengan performa mendekati native. Lihat dokumentasi KVM untuk penggunaan bersama KVM.

Instalasi

sudo xbps-install -S qemu

Paket qemu menyertakan emulator untuk semua arsitektur yang didukung:

Manajemen Disk Image

Membuat Disk Image

# Format qcow2 (disarankan — mendukung snapshot dan kompresi)
qemu-img create -f qcow2 disk.qcow2 20G

# Format raw (performa lebih tinggi, ukuran tetap)
qemu-img create -f raw disk.raw 20G

Melihat Info Disk Image

qemu-img info disk.qcow2

Mengubah Ukuran Disk Image

qemu-img resize disk.qcow2 +10G   # Tambah 10GB
qemu-img resize disk.qcow2 30G    # Set ke ukuran tertentu

Konversi Format Disk

# raw → qcow2
qemu-img convert -f raw -O qcow2 disk.raw disk.qcow2

# vmdk → qcow2 (dari VMware)
qemu-img convert -f vmdk -O qcow2 disk.vmdk disk.qcow2

Membuat Snapshot

# Buat snapshot
qemu-img snapshot -c nama_snapshot disk.qcow2

# Lihat daftar snapshot
qemu-img snapshot -l disk.qcow2

# Restore snapshot
qemu-img snapshot -a nama_snapshot disk.qcow2

# Hapus snapshot
qemu-img snapshot -d nama_snapshot disk.qcow2

Menjalankan VM

Perintah Dasar

qemu-system-x86_64 \
    -enable-kvm \
    -m 2G \
    -smp 2 \
    -drive file=disk.qcow2,format=qcow2 \
    -cdrom installer.iso \
    -boot d

Opsi Umum