75 lines
4.6 KiB
HTML
75 lines
4.6 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>Install — Keru OS</title>
|
|
<meta name="description" content="How to install Keru: boot the ISO, the installer starts itself, choose your components, and Keru builds your system from source.">
|
|
<link rel="stylesheet" href="assets/css/style.css">
|
|
<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>ける</text></svg>">
|
|
</head>
|
|
<body>
|
|
|
|
<nav class="top" data-nav></nav>
|
|
|
|
<header class="pagehead">
|
|
<p class="crumbs"><a href="index.html">home</a> / install</p>
|
|
<h1>Install Keru</h1>
|
|
<p>Boot the ISO. The installer starts itself. You choose. It builds.</p>
|
|
</header>
|
|
|
|
<section>
|
|
<div class="wrap">
|
|
<div class="prose">
|
|
<h3>The whole flow</h3>
|
|
<p>Keru ships as a live ISO that carries <strong>only the installer</strong>. There is no prebuilt base image on the disk. The entire system — toolchain, kernel, init, libc, filesystem tooling — is fetched and compiled during installation, on the fly.</p>
|
|
|
|
<div class="callout"><strong>Network required.</strong> A working connection is a hard requirement for installing Keru. The installer checks it, and if you're not connected it offers to run <code>nmtui</code> for you.</div>
|
|
|
|
<h3>Step by step</h3>
|
|
<ol>
|
|
<li><strong>Boot the ISO.</strong> The live init (<code>live/init</code>) mounts the essentials and launches the installer automatically. No shell prompt, no manual boot gymnastics — it just starts.</li>
|
|
<li><strong>Connect if asked.</strong> If there's no network yet, you'll be prompted. Say yes and <code>nmtui</code> opens; connect, then continue. The installer re-checks until you're online.</li>
|
|
<li><strong>Choose your system.</strong> The installer walks through each swappable: init system, C library, filesystem, kernel, privilege elevation, network tools. Defaults are one enter-key away.</li>
|
|
<li><strong>Resolve the stability check.</strong> Unproven combinations get a warning, never a block. If it's risky, you're told — then you decide.</li>
|
|
<li><strong>Build.</strong> Confirm, and Keru fetches and compiles your exact system from source into a rootfs, then writes it to disk.</li>
|
|
<li><strong>Boot what you chose.</strong> Fixed at first boot. The system that lands is precisely the one you designed.</li>
|
|
</ol>
|
|
|
|
<h3>What the installer asks you</h3>
|
|
<table>
|
|
<tr><th>Component</th><th>Options</th></tr>
|
|
<tr><td>Init system</td><td>runit · s6 · openrc · systemd · busybox-init · sysvinit · dinit · shepherd</td></tr>
|
|
<tr><td>C library</td><td>glibc · musl · uclibc-ng</td></tr>
|
|
<tr><td>Filesystem</td><td>ext4 · ext2 · ext3 · btrfs · xfs · zfs · f2fs · jfs · reiserfs</td></tr>
|
|
<tr><td>Kernel</td><td>linux · linux-lts · linux-hardened · linux-cachyos · linux-zen</td></tr>
|
|
<tr><td>Privilege elevation</td><td>doas · sudo · opendoas · su</td></tr>
|
|
<tr><td>Network tools</td><td>nmtui · networkmanager · connman · systemd-networkd</td></tr>
|
|
</table>
|
|
|
|
<h3>What it writes</h3>
|
|
<p>Your choices are assembled into a <code>make.conf</code>, then handed to the build pipeline: <code>scripts/build-root.sh</code> drives Kama through toolchain bootstrap, base system, kernel, init, and tooling. The result — a rootfs matching your profile — is finalized with <code>mkfs-root.sh</code> and written to the target filesystem.</p>
|
|
|
|
<div class="code-block"># Generated by keru-install — hand-tune then rebuild if you like.
|
|
INIT=runit
|
|
LIBC=glibc
|
|
TARGET_FS=ext4
|
|
KERNEL=linux
|
|
SUDO=doas
|
|
NET=nmtui
|
|
LICENSE_ACCEPT=(*)</div>
|
|
|
|
<div class="callout ok"><strong>From scratch, every time.</strong> There's no binary base to seed. The toolchain is bootstrapped — gcc, binutils, your libc — then the rest on top. This is the "fully from scratch" path, kept honest.</div>
|
|
|
|
<p><a href="installer-walkthrough.html">Walk through the installer in detail</a> · <a href="installation-requirements.html">See the requirements</a> · <a href="network-setup.html">Network setup details</a></p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<footer data-footer></footer>
|
|
|
|
<noscript><div style="text-align:center;padding:16px">See the <a href="sitemap.html">sitemap</a> for all pages.</div></noscript>
|
|
|
|
<script src="assets/js/include.js" data-base="."></script>
|
|
</body>
|
|
</html> |