Sami Ahmed
970177482b
- Basic archiso profile with CLI-only system - Custom 'samios' CLI tool for system management - BIOS (syslinux) and UEFI (grub) boot support - System configuration (hostname, locale, network) - Automated script for first boot - Mirror selection utility - Documentation (README, installation guide, roadmap) - Font policy: excludes fonts with '7777' in name Next: automated installer, desktop environment, testing
101 lines
1.7 KiB
Markdown
101 lines
1.7 KiB
Markdown
# SamiOS Installation Guide
|
|
|
|
## Prerequisites
|
|
- SamiOS ISO (built from source or downloaded)
|
|
- USB drive (2GB+) or CD/DVD
|
|
- Target machine with at least 2GB RAM
|
|
- 20GB+ storage space
|
|
|
|
## Creating Bootable Media
|
|
|
|
### Linux
|
|
```bash
|
|
# Find your USB device
|
|
lsblk
|
|
|
|
# Write ISO to USB (replace /dev/sdX with your device)
|
|
sudo dd if=samios-*.iso of=/dev/sdX bs=4M status=progress oflag=sync
|
|
```
|
|
|
|
### Windows
|
|
Use Rufus or Etcher to write the ISO to USB.
|
|
|
|
## Installation Process
|
|
|
|
### 1. Boot from Media
|
|
- Insert USB/CD and boot the target machine
|
|
- Select "SamiOS Live" from the boot menu
|
|
|
|
### 2. Connect to Network (if needed)
|
|
```bash
|
|
# WiFi
|
|
iwctl
|
|
[iwd]# device list
|
|
[iwd]# station wlan0 scan
|
|
[iwd]# station wlan0 get-networks
|
|
[iwd]# station wlan0 connect YOUR_SSID
|
|
[iwd]# exit
|
|
|
|
# Ethernet (auto-connects)
|
|
```
|
|
|
|
### 3. Run Installer
|
|
```bash
|
|
samios install
|
|
```
|
|
|
|
The installer will:
|
|
- Partition the disk
|
|
- Install base system
|
|
- Configure bootloader
|
|
- Set up user account
|
|
|
|
### 4. Reboot
|
|
```bash
|
|
reboot
|
|
```
|
|
|
|
Remove installation media and boot into SamiOS.
|
|
|
|
## Post-Installation
|
|
|
|
### Update System
|
|
```bash
|
|
samios update
|
|
```
|
|
|
|
### Install Additional Packages
|
|
```bash
|
|
samios install firefox
|
|
samios install vim
|
|
```
|
|
|
|
### Configure System
|
|
```bash
|
|
samios status
|
|
samios fonts
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Boot Issues
|
|
- Try "Copy to RAM" option from boot menu
|
|
- Check BIOS/UEFI settings (Secure Boot may need to be disabled)
|
|
|
|
### Network Issues
|
|
```bash
|
|
# Check network status
|
|
ip addr
|
|
ping -c 3 archlinux.org
|
|
|
|
# Restart NetworkManager
|
|
systemctl restart NetworkManager
|
|
```
|
|
|
|
### Installation Fails
|
|
- Check disk space: `df -h`
|
|
- Check logs: `journalctl -xe`
|
|
|
|
## Support
|
|
For issues and questions, please open an issue on the SamiOS repository.
|