Updated readme
Some checks failed
Checks / Spelling (push) Has been cancelled
Checks / Python Linters (push) Has been cancelled
Checks / Shell Linters (push) Has been cancelled
Checks / 📦 Packit config lint (push) Has been cancelled
Checks / 🔍 Check for valid snapshot urls (push) Has been cancelled
Checks / 🔍 Check JSON files for formatting consistency (push) Has been cancelled
Generate / Documentation (push) Has been cancelled
Generate / Test Data (push) Has been cancelled
Tests / Unittest (push) Has been cancelled
Tests / Assembler test (legacy) (push) Has been cancelled
Tests / Smoke run: unittest as normal user on default runner (push) Has been cancelled

This commit is contained in:
robojerk 2025-08-26 17:00:30 -07:00
parent 5ab0c39b08
commit 816bd69f97

View file

@ -77,6 +77,37 @@ Testing requires additional software:
- **bookworm** (Debian 12) - OLDSTABLE - Limited compatibility
- **bullseye** (Debian 11) - OLDOLDSTABLE - Not supported
## Dynamic Runner System
Debian Forge automatically detects your distribution and uses the appropriate runner, just like Fedora OSBuild:
```bash
# OSBuild automatically detects and uses the right runner
$ ls -la runners/
org.osbuild.debian13* # Debian 13 (Trixie) runner
org.osbuild.debian14* # Debian 14 (Forky) runner
org.osbuild.ubuntu2504* # Ubuntu 25.04 (Plucky Puffin) runner
org.osbuild.ubuntu2404* # Ubuntu 24.04 (Noble Numbat) runner
org.osbuild.debian-based* # Generic Debian-based runner
org.osbuild.linux* # Generic Linux runner
```
### Automatic Setup
```bash
# Setup the appropriate runner for your system
$ ./tools/debian-runner-setup
# List available runners
$ ./tools/debian-runner-setup list
```
### Supported Distributions
- **Debian**: Trixie (13), Forky (14), Sid (unstable)
- **Ubuntu**: 24.04 LTS, 25.04 LTS, and future releases
- **Other**: Linux Mint, Pop!_OS, Elementary OS, Zorin OS, Kali Linux, Parrot OS
## Running locally
The main binary is safe to run on your development machine with: