https://github.com/sunlightlinux/slinstaller
System installer for Sunlight Linux (UEFI-only). Beta stopgap: void-installer fork; long-term target: a Go rewrite modeled on clr-installer.
https://github.com/sunlightlinux/slinstaller
backports go installer shell sunlight sunlight-linux uefi
Last synced: 8 days ago
JSON representation
System installer for Sunlight Linux (UEFI-only). Beta stopgap: void-installer fork; long-term target: a Go rewrite modeled on clr-installer.
- Host: GitHub
- URL: https://github.com/sunlightlinux/slinstaller
- Owner: sunlightlinux
- License: apache-2.0
- Created: 2026-05-24T16:10:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-24T17:44:43.000Z (about 1 month ago)
- Last Synced: 2026-05-24T19:26:11.499Z (about 1 month ago)
- Topics: backports, go, installer, shell, sunlight, sunlight-linux, uefi
- Homepage:
- Size: 16.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# slinstaller
The system installer for **Sunlight Linux**, a UEFI-only Linux distribution.
> **Status: early bootstrap.** This repository is being seeded. The first
> iteration is a fork of **void-installer** — the installer shipped in
> [void-mklive](https://github.com/void-linux/void-mklive) — as a beta stopgap;
> the long-term target is a ground-up rewrite in **Go**, modeled on
> [clr-installer](https://github.com/clearlinux/clr-installer).
## What it does
slinstaller partitions the target disk, lays down the Sunlight Linux base
system, installs the bootloader, and configures the first boot — including
[slinit](https://github.com/sunlightlinux/slinit) as PID 1.
## Target requirements
- **UEFI firmware.** Sunlight Linux is UEFI-only: the installer creates a GPT
layout with an EFI System Partition (ESP) and registers a boot entry with
`efibootmgr`. BIOS/MBR boot is not supported.
## Building / Running
Implementation is in progress; the commands below describe the intended flow.
- **Go target:**
```bash
go build ./... # produces the slinstaller binary
go test ./...
```
- **Stopgap (void-installer fork):** shell-based; runs as root from the live
medium. The live medium / ISO is built with
[void-mklive](https://github.com/void-linux/void-mklive), which is also where
upstream `void-installer` lives.
> ⚠️ The installer performs **destructive, irreversible** operations
> (partitioning, formatting, bootloader install). Always exercise changes in a
> VM (QEMU + OVMF for UEFI) against a scratch image — never on a disk with data
> you care about.
## Where this fits
slinstaller is one of the five projects in the Sunlight Linux tree, wired up
via [slmanifests](https://github.com/sunlightlinux/slmanifests):
```bash
repo init -u https://github.com/sunlightlinux/slmanifests.git -b main
repo sync -j4
# slinstaller lands at src/installer/
```
## Documentation
- [CONTRIBUTING.md](CONTRIBUTING.md) — how to contribute (and the safety rules)
- [SECURITY.md](SECURITY.md) — reporting security issues
- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) — community standards
- [CLAUDE.md](CLAUDE.md) / [EXAMPLES.md](EXAMPLES.md) — guidelines for
LLM-assisted work on the installer
## License
[Apache License 2.0](LICENSE).