Repository navigation
MiniOS Applications
MiniOS provides graphical and command-line tools for configuration, installation, sessions, modules, kernels, software, and image remastering. These tools are designed around the modular live architecture described in About MiniOS.
The available tools depend on the packages included in the MiniOS image. Check a running live system with dpkg-query, or inspect the image modules and package manifests.
A native installation keeps the familiar MiniOS desktop experience — its visual identity, selected desktop environment, and ordinary applications — but it does not keep the MiniOS-specific management software designed for the live architecture. Sessions, .sb modules, modular kernel management, and similar workflows no longer apply, so the installed system uses normal Debian package, kernel, configuration, and bootloader tools instead.
| Task | Tool | Scope | Documentation |
|---|---|---|---|
| Edit MiniOS boot-time and new-session settings | MiniOS Configurator | For the MiniOS live configuration model. It writes settings for a later live boot and does not reconfigure the running system immediately. | MiniOS Configurator |
| Deploy MiniOS to another disk | MiniOS Installer | Runs from a MiniOS live session. Live mode keeps the complete MiniOS live environment; native mode creates a conventional Debian desktop and removes the MiniOS-specific software intended for live operation. | MiniOS Installer |
| Create, select, mount, resize, save, reclaim, encrypt, or remove persistent sessions | MiniOS Session Manager | MiniOS live systems only. It can write supported RAM-backed sessions to their original store, change detached LUKS passphrases, and mount inactive container sessions for file access. | Session management |
| Package, activate, inspect, or remove MiniOS kernels | MiniOS Kernel Manager | MiniOS modular live systems only. Repository packaging can also add compatible drivers from the curated MiniOS DKMS catalog. | Kernel management |
| Install applications or build application modules from catalog recipes | MiniOS Store | MiniOS live systems. Module builds can keep a recipe level or use an explicit build-base level; recipes can require license acceptance. | MiniOS Store |
| Remaster an existing MiniOS image through a guided project | MiniOS Image Builder | Uses the running session, an ISO, or optical media. Session capture requires the running-session source with its complete source and active external module set; it is unavailable for separately selected ISO/optical sources. | MiniOS Image Builder |
Inspect, create, activate, and select .sb modules |
MiniOS Module Manager | MiniOS live systems only; module composition and runtime activation depend on the layered .sb root model. |
MiniOS Module Manager |
| Write/read disk images, format storage, or erase a device | Drive Utility | Generic storage utility included with MiniOS. Raw image writing does not perform managed deployment like MiniOS Installer. | Drive Utility |
| Browse the installed documentation offline | MiniOS Help | Native GTK viewer for a precompiled documentation bundle; it does not require the website, WebKit, or a network connection at runtime. | MiniOS documentation |
| Show the localized first-run introduction | MiniOS Welcome | Local browser-based welcome page with Mio, project links, help, community, and support prompts. It is introductory content rather than a system configurator. | Quick start |
Most graphical tools have a public command-line counterpart or backend. The core manifest requests minios-tools for every edition and minios-image-compose, minios-deploy, minios-kernel, and minios-session for non-minimum variants, independently of the graphical desktop tools. Flux uses the minimum variant and does not request those four companion backends by default. Check actual installed packages; dependencies and custom images can add tools beyond the manifest.
| Task | Tool | Scope | Documentation |
|---|---|---|---|
| List target disks, preview a deployment plan, or install MiniOS non-interactively | minios-deploy |
Runs from a MiniOS live session. Installation requires root and explicit confirmation; native mode, when supported, creates a conventional Debian desktop from the selected image. |
Command-line deployment; man minios-deploy
|
| Create, activate, save, mount, resize, reclaim, change encryption credentials, export, import, or remove persistent sessions | minios-session |
Requires root and a MiniOS live system with a compatible persistence store. RAM-backed save, detached mounts, and backend-specific operations are capability-gated. |
Session command reference; man minios-session
|
| Task | Tool | Scope | Documentation |
|---|---|---|---|
| List, package, activate, inspect, or remove kernels | minios-kernel |
Requires root and a modular MiniOS live installation with a writable MiniOS root. |
minios-kernel CLI; man minios-kernel
|
| Remaster an existing MiniOS content tree from scripts or automation | minios-image-compose |
Operates on MiniOS live image content and publishes a bootable ISO. |
Composing ISO images from the command line; man minios-image-compose
|
| Task | Tool | Scope | Documentation |
|---|---|---|---|
| Inspect modules and manage the running or next-boot module sets | sb |
Module inspection also works outside a running MiniOS session. Running and next-boot operations require a MiniOS live module layout; changes require root. |
Inspect and extract modules; manage running and next-boot modules; man sb
|
Build a module from repository packages or local .deb files |
apt2sb |
Requires root and a supported MiniOS live session. Packages are installed into an isolated build environment, not the running root. |
Create a module from packages; man apt2sb
|
| Build a module by running an installation script | script2sb |
Requires root and a supported MiniOS live session. The script runs non-interactively in an isolated build environment. |
Create a module from a script; man script2sb
|
| Build a module interactively in a prepared environment | chroot2sb |
Requires root and a supported MiniOS live session. Use it when installation needs prompts or manual changes. |
Create a module interactively; man chroot2sb
|
Convert between a directory tree and an .sb module |
dir2sb, sb2dir
|
Ordinary conversion is rootless and can run outside a live session. Faithful extraction and repackaging with original owners and special files require root; graphical workflows request administrator authentication. |
Create or extract a module; man dir2sb, man sb2dir
|
| Capture eligible changes from the writable session layer into a module | savechanges |
Requires root and a running MiniOS live session with a supported writable-layer backend. |
Capture current-session changes; man savechanges
|
| Task | Tool | Scope | Documentation |
|---|---|---|---|
| Read or write disk images, format a device, or erase storage |
driveutility-read, driveutility-write, driveutility-format, driveutility-wipe
|
Generic disk operations. Wipe supports controller erase, discard, and host overwrite methods where the device and required tools support them. Destructive operations normally require root. |
Drive Utility; man driveutility-read, man driveutility-write, man driveutility-format, man driveutility-wipe
|
For changes to source package lists, kernels, boot artifacts, or the complete module chain, use the source build system instead of either image-remastering tool. See Building MiniOS.
🌐 Languages
📋 Getting started
🚀 Installing MiniOS
- Installation methods
- Verifying downloads
- Installation tools
- Manual file-based installation
- MiniOS Installer
🖥️ Using MiniOS
⚙️ Preparing and customizing MiniOS
- Preconfiguring MiniOS
- Managing modules
- Managing kernels
- Creating custom MiniOS images
- Customizing the boot menu
🛡️ Maintenance and recovery
📖 Reference
- System architecture
- Boot process
- Boot parameters
- Configuration
- Package and edition contents
🛠️ Development
📋 Erste Schritte
🚀 MiniOS installieren
- Installationsmethoden
- Downloads verifizieren
- Installationswerkzeuge
- Manuelle dateibasierte Installation
- MiniOS-Installationsprogramm
🖥️ MiniOS verwenden
⚙️ MiniOS vorbereiten und anpassen
- MiniOS vorkonfigurieren
- Module verwalten
- Kernel verwalten
- Eigene MiniOS-Images erstellen
- Startmenü anpassen
🛡️ Wartung und Wiederherstellung
📖 Referenz
- Systemarchitektur
- Startvorgang
- Startparameter
- Konfiguration
- Paket- und Editionsinhalte
🛠️ Entwicklung
📋 Primeros pasos
🚀 Instalando MiniOS
- Métodos de instalación
- Verificación de descargas
- Herramientas de instalación
- Instalación manual basada en archivos
- Instalador de MiniOS
🖥️ Usar MiniOS
⚙️ Preparar y personalizar MiniOS
- Preconfiguración de MiniOS
- Gestión de módulos
- Gestión de kernels
- Creación de imágenes personalizadas de MiniOS
- Personalizar el menú de arranque
🛡️ Mantenimiento y recuperación
- Actualizar MiniOS
- Copia de seguridad de MiniOS
- Solución de problemas
- Seguridad
- Rendimiento
- Virtualización
📖 Referencia
- Arquitectura del sistema
- Proceso de arranque
- Parámetros de arranque
- Configuración
- Contenido de paquetes y ediciones
🛠️ Desarrollo
📋 Premiers pas
🚀 Installation de MiniOS
- Méthodes d'installation
- Vérification des téléchargements
- Outils d'installation
- Installation manuelle basée sur les fichiers
- Programme d’installation MiniOS
🖥️ Utiliser MiniOS
⚙️ Préparer et personnaliser MiniOS
- Préconfiguration de MiniOS
- Gestion des modules
- Gestion des noyaux
- Créer des images MiniOS personnalisées
- Personnaliser le menu de démarrage
🛡️ Maintenance et récupération
📖 Référence
- Architecture du système
- Processus de démarrage
- Paramètres de démarrage
- Configuration
- Contenu des paquets et éditions
🛠️ Développement
📋 Memulai
🚀 Menginstal MiniOS
- Metode instalasi
- Memverifikasi unduhan
- Alat instalasi
- Instalasi manual berbasis file
- Penginstal MiniOS
🖥️ Menggunakan MiniOS
⚙️ Menyiapkan dan menyesuaikan MiniOS
- Pra-konfigurasi MiniOS
- Mengelola modul
- Mengelola kernel
- Membuat citra MiniOS kustom
- Menyesuaikan menu boot
🛡️ Pemeliharaan dan pemulihan
📖 Referensi
- Arsitektur sistem
- Proses boot
- Parameter boot
- Konfigurasi
- Isi paket dan edisi
🛠️ Pengembangan
📋 Per iniziare
🚀 Installazione di MiniOS
- Metodi di installazione
- Verifica dei download
- Strumenti di installazione
- Installazione manuale basata su file
- Installatore MiniOS
🖥️ Usare MiniOS
⚙️ Preparare e personalizzare MiniOS
- Preconfigurazione di MiniOS
- Gestione dei moduli
- Gestione dei kernel
- Creazione di immagini MiniOS personalizzate
- Personalizzazione del menu di avvio
🛡️ Manutenzione e ripristino
- Aggiornamento di MiniOS
- Backup di MiniOS
- Risoluzione dei problemi
- Sicurezza
- Prestazioni
- Virtualizzazione
📖 Riferimento
- Architettura di sistema
- Processo di avvio
- Parametri di avvio
- Configurazione
- Contenuto di pacchetti ed edizioni
🛠️ Sviluppo
📋 Primeiros passos
🚀 Instalando o MiniOS
- Métodos de instalação
- Verificando downloads
- Ferramentas de instalação
- Instalação manual baseada em arquivos
- Instalador do MiniOS
🖥️ Usar MiniOS
⚙️ Preparando e personalizando o MiniOS
- Pré-configurando o MiniOS
- Gerenciando módulos
- Gerenciando kernels
- Criando imagens personalizadas do MiniOS
- Personalizando o menu de boot
🛡️ Manutenção e recuperação
- Atualizando o MiniOS
- Fazendo backup do MiniOS
- Solução de problemas
- Segurança
- Desempenho
- Virtualização
📖 Referência
- Arquitetura do sistema
- Processo de boot
- Parâmetros de boot
- Configuração
- Conteúdo dos pacotes e edições
🛠️ Desenvolvimento
📋 Начало работы
🚀 Установка MiniOS
- Методы установки
- Проверка загрузок
- Инструменты установки
- Ручная установка на основе файлов
- Установщик MiniOS
🖥️ Использование MiniOS
⚙️ Подготовка и настройка MiniOS
- Предварительная настройка MiniOS
- Управление модулями
- Управление ядрами
- Создание пользовательских образов MiniOS
- Настройка загрузочного меню
🛡️ Обслуживание и восстановление
- Обновление MiniOS
- Резервное копирование MiniOS
- Устранение неполадок
- Безопасность
- Производительность
- Виртуализация
📖 Справочник
- Архитектура системы
- Процесс загрузки
- Параметры загрузки
- Конфигурация
- Содержимое пакета и редакций
🛠️ Разработка