Installation

Installation

Quick Start

Create Bootable USB

sudo dd if=madOS-*.iso of=/dev/sdX bs=4M status=progress oflag=sync

Replace /dev/sdX with your USB device (check with lsblk).

Boot

1. Boot from USB
2. Sway compositor auto-starts in live environment
3. Connect to WiFi if needed

Install

sudo install-mados

The smart launcher auto-selects:

• GTK Installer - If running under Wayland/X11
• TUI Installer - Text-based fallback

Follow the installer wizard:

1. Select installation disk
2. Create user account
3. Configure timezone
4. Review settings
5. Confirm installation

First Boot

1. Remove USB and reboot
2. System auto-logs to TTY1
3. Sway starts automatically
4. Run opencode for AI assistance

Installers

Installer	Command	Description
Smart (Auto)	sudo install-mados	Auto-detects best option
GTK	sudo install-mados-gtk.py	Graphical interface
TUI	sudo install-mados	Text-based

Requirements

Component	Minimum	Recommended
CPU	Intel Atom	Any x86_64
RAM	1.9GB	2GB+
Storage	25GB	64GB+
GPU	Open drivers	Any