v0.1.0: Initial SamiOS archiso profile

- 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
This commit is contained in:
Sami Ahmed
2026-08-11 01:12:07 -07:00
commit 970177482b
23 changed files with 613 additions and 0 deletions
+100
View File
@@ -0,0 +1,100 @@
# 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.
+67
View File
@@ -0,0 +1,67 @@
# SamiOS Roadmap
## Phase 1: Foundation (Current)
- [x] Basic archiso profile
- [x] CLI tool (`samios`)
- [x] Boot configuration (BIOS + UEFI)
- [x] System configuration files
- [ ] Automated installer
- [ ] Font management system
- [ ] Build automation
## Phase 2: Desktop Environment
- [ ] KDE Plasma integration
- [ ] Display manager (SDDM)
- [ ] Graphics drivers (NVIDIA/AMD/Intel)
- [ ] Audio setup (PipeWire)
- [ ] Network management GUI
- [ ] System settings GUI
## Phase 3: Applications
- [ ] Web browser (Firefox/Chromium)
- [ ] File manager (Dolphin)
- [ ] Terminal emulator (Konsole)
- [ ] Text editor (Kate)
- [ ] Office suite (LibreOffice)
- [ ] Media player (VLC)
- [ ] Image viewer (Gwenview)
## Phase 4: System Tools
- [ ] Package manager GUI (Pamac)
- [ ] System monitor
- [ ] Backup tool
- [ ] Firewall configuration
- [ ] User management GUI
## Phase 5: Polish
- [ ] Custom themes
- [ ] SamiOS branding
- [ ] Documentation
- [ ] Testing suite
- [ ] Release automation
## Phase 6: Advanced Features
- [ ] Dual-boot setup tool
- [ ] System recovery tools
- [ ] Snapshot/rollback (Btrfs)
- [ ] Container support (Docker/Podman)
- [ ] Virtual machine support
## Long-term Goals
- [ ] Custom kernel with optimizations
- [ ] SamiOS-specific packages
- [ ] Community repository
- [ ] Hardware certification
- [ ] Enterprise features
## Timeline
- Phase 1: Q4 2024
- Phase 2: Q1 2025
- Phase 3: Q2 2025
- Phase 4-6: Ongoing
## Notes
- Prioritize stability over features
- Keep system lightweight
- Maintain Arch compatibility
- Focus on daily-driver usability