migrate website from KeruOS web to its own repo

2026-09-01 12:06:36 +02:00
commit 4a32fab414
56 changed files with 4120 additions and 0 deletions
@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Getting started — Keru OS</title>
+<meta name="description" content="From booting the Keru ISO to a first-boot system: prerequisites, the install flow, network, and day one.">
+<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> / <a href="docs.html">docs</a> / getting started</p>
+    <h1>Getting started</h1>
+    <p>Zero to a chosen, booting, source-built system.</p>
+</header>
+
+<section>
+    <div class="wrap">
+        <div class="prose">
+            <p>Keru 0.1 ships as an ISO. There is no source build to DIY, no binary download, no flashing a rootfs tarball. Boot the ISO, answer the installer, and Keru builds exactly what you chose while you watch.</p>
+
+            <h3>Before you begin</h3>
+            <ul class="features">
+                <li><strong>A working network.</strong> The build is fully online — every source tarball is downloaded fresh at install time.</li>
+                <li><strong>A spare target disk.</strong> <code>mkfs-root.sh</code> formats whatever root device the installer points at. It will be written over.</li>
+                <li><strong>Patience for the first build.</strong> Fetch + compile of the full toolchain and system takes a while on modest hardware.</li>
+                <li><strong>Decisions.</strong> Prep your picks ahead — or just press enter; sane defaults are documented on every prompt.</li>
+            </ul>
+
+            <h3>The flow</h3>
+            <div class="code-block">1. Write the ISO to USB          sudo dd if=keru-0.1.iso of=/dev/sdX bs=4M status=progress
+2. Boot the stick               BIOS/UEFI → the live image starts by itself
+3. live/init mounts & runs      the installer launches automatically on boot
+4. Connect to the network       the installer runs nmtui for you when offline
+5. Make your picks              init · libc · fs · kernel · sudo · net
+6. Keru builds the system       fetch → stage 0 toolchain → base → swappables
+7. First boot                   your crafted system, exactly as chosen</div>
+
+            <h3>Your picks</h3>
+            <table>
+                <tr><th>Choice</th><th>Default</th><th>Why you might change it</th></tr>
+                <tr><td>Init system</td><td><code>runit</code></td><td>systemd for optional use — but Keru never forces it.</td></tr>
+                <tr><td>C library</td><td><code>glibc</code></td><td>musl for a smaller static-leaning system.</td></tr>
+                <tr><td>Filesystem</td><td><code>ext4</code></td><td>btrfs snapshots, zfs features, xfs scaling.</td></tr>
+                <tr><td>Kernel</td><td><code>linux</code></td><td>linux-lts for longevity, hardened for attacks.</td></tr>
+                <tr><td>Privilege elevation</td><td><code>doas</code></td><td>sudo if you live in its muscle memory.</td></tr>
+                <tr><td>Network tools</td><td><code>nmtui</code></td><td>networkmanager, connman, or systemd-networkd.</td></tr>
+            </table>
+
+            <div class="callout">Every option here has a dedicated page. See <a href="swappables.html">the swappables guide</a> and its sub-pages before you install, so boot rehearsal is boring by design.</div>
+
+            <h3>Day one</h3>
+            <p>Keru installs a bare, honest base — the packages you chose plus the few kama needs to run. From there you shape the rest:</p>
+            <div class="code-block"># your system, your way
+kama make vim          # build anything else from source
+kama info busybox      # peek at a recipe's metadata
+doas kama install tmux</div>
+            <p>Everything you don't install, you don't get. No services pretending to be useful, no telemetry phone-home.</p>
+
+            <div class="callout ok">Now read the <a href="installer-walkthrough.html">installer walkthrough</a> for the fine detail, or go straight to <a href="troubleshooting.html">troubleshooting</a> when something surprises you.</div>
+
+            <p><a href="install.html">← Install overview</a> · <a href="network-setup.html">Network setup</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>