Sam & Claude
faf060e0ce
Replaces public split-brain wording with Layered Memory Fabric, documents the skills/brain/ops planes, and sketches the shared FreeBSD/Linux install contract around PostgreSQL, ZFS/OpenZFS, and platform isolation adapters.\n\nChecks: npx --yes prettier@3 --check touched docs/html; git diff --check --- Build: pass | Tests: FAIL — 1 failed
257 lines
8.8 KiB
HTML
257 lines
8.8 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>ISO Install — Clawdie Docs</title>
|
|
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
|
<link
|
|
href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,300;0,400;0,600;1,300;1,400&family=DM+Mono:wght@300;400&display=swap"
|
|
rel="stylesheet"
|
|
/>
|
|
<link rel="stylesheet" href="/css/shared.css" />
|
|
</head>
|
|
<body>
|
|
<div class="hex-bg"></div>
|
|
<div class="sidebar-overlay" id="overlay"></div>
|
|
|
|
<header class="top-bar">
|
|
<button class="mobile-menu-btn" id="menuBtn" aria-label="Toggle menu">
|
|
☰
|
|
</button>
|
|
<a href="/" class="brand"><span>△</span> Clawdie Docs</a>
|
|
<div class="nav-links">
|
|
<a href="https://clawdie.si">Home</a>
|
|
<a href="https://codeberg.org/Clawdie" target="_blank" rel="noopener"
|
|
>Source</a
|
|
>
|
|
</div>
|
|
</header>
|
|
|
|
<div class="docs-layout">
|
|
<nav class="sidebar" id="sidebar">
|
|
<div class="sidebar-section">
|
|
<span class="section-label">Getting Started</span>
|
|
<ul>
|
|
<li><a href="/">Introduction</a></li>
|
|
<li><a href="/docs/install.html">Installation</a></li>
|
|
<li><a href="/docs/iso.html" class="active">ISO Install</a></li>
|
|
<li><a href="/docs/split-brain.html">Layered Memory</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sidebar-section">
|
|
<span class="section-label">Architecture</span>
|
|
<ul>
|
|
<li><a href="/docs/">How It Works</a></li>
|
|
<li><a href="/docs/#jails-not-docker">Jails, Not Docker</a></li>
|
|
<li><a href="/docs/#wayland-first-display">Wayland Display</a></li>
|
|
<li>
|
|
<a href="/docs/#prompt-injection-and-web-browsing"
|
|
>Prompt Injection</a
|
|
>
|
|
</li>
|
|
<li>
|
|
<a href="/guides/nanoclaw-upstream.html">NanoClaw Upstream</a>
|
|
</li>
|
|
<li>
|
|
<a
|
|
href="https://codeberg.org/Clawdie/Clawdie-AI/src/branch/main/docs/public/operate/monitoring.md"
|
|
target="_blank"
|
|
rel="noopener"
|
|
>Monitoring</a
|
|
>
|
|
</li>
|
|
<li>
|
|
<a
|
|
href="https://codeberg.org/Clawdie/Clawdie-AI/src/branch/main/docs/public/operate/security.md"
|
|
target="_blank"
|
|
rel="noopener"
|
|
>Security</a
|
|
>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="sidebar-section">
|
|
<span class="section-label">Setup Guides</span>
|
|
<ul>
|
|
<li><a href="/guides/nginx-ssl.html">Nginx + SSL</a></li>
|
|
<li><a href="/guides/tailscale-vpn.html">Tailscale VPN</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sidebar-section">
|
|
<span class="section-label">Integrations</span>
|
|
<ul>
|
|
<li><a href="/guides/stripe-agents.html">Stripe Agents</a></li>
|
|
<li><a href="/guides/protonmail.html">ProtonMail</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sidebar-section">
|
|
<span class="section-label">Project</span>
|
|
<ul>
|
|
<li><a href="/changelog.html">Changelog</a></li>
|
|
<li><a href="/license.html">License</a></li>
|
|
</ul>
|
|
</div>
|
|
</nav>
|
|
|
|
<main class="content">
|
|
<div class="breadcrumb">
|
|
<a href="/">Home</a><span class="sep">/</span>
|
|
<a href="/docs/">Docs</a><span class="sep">/</span>
|
|
ISO Install
|
|
</div>
|
|
|
|
<div class="page-header">
|
|
<h1>ISO <span>Install</span></h1>
|
|
<p class="subtitle">
|
|
Bootable USB images for bare metal and offline installs
|
|
</p>
|
|
</div>
|
|
|
|
<p>
|
|
Clawdie ISO images are built in a separate repository —
|
|
<a
|
|
href="https://codeberg.org/Clawdie/Clawdie-ISO"
|
|
target="_blank"
|
|
rel="noopener"
|
|
>Clawdie-ISO</a
|
|
>. The ISO path bundles a FreeBSD base image, offline packages, and a
|
|
preloaded Clawdie checkout so you can install without live package
|
|
fetches.
|
|
</p>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>When to use the ISO</h2>
|
|
<p>
|
|
Use the ISO path when you want a clean bare metal install, when you
|
|
are deploying without reliable internet access, or when you want a
|
|
repeatable USB-based workflow for lab or field deployments.
|
|
</p>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>Download</h2>
|
|
<p>
|
|
ISO images are published on the Clawdie-ISO release page:
|
|
<a
|
|
href="https://codeberg.org/Clawdie/Clawdie-ISO/releases"
|
|
target="_blank"
|
|
rel="noopener"
|
|
>Codeberg releases</a
|
|
>. Choose the bare metal image for desktop installs and the cloud
|
|
image for headless VPS-style deployments.
|
|
</p>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>Write the USB</h2>
|
|
<p>
|
|
Write the image to a USB device. Replace <code>/dev/daX</code> with
|
|
the correct device.
|
|
</p>
|
|
<pre><code>sudo dd if=clawdie-iso-baremetal-DD.mmm.YYYY.img of=/dev/daX bs=1M status=progress</code></pre>
|
|
<p>
|
|
Use <code>camcontrol devlist</code> if you need help finding the
|
|
correct USB target.
|
|
</p>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>First boot and setup</h2>
|
|
<p>
|
|
Boot the machine from the USB, complete onboarding, and then run the
|
|
normal setup flow from the preloaded Clawdie checkout. The install
|
|
orchestrator creates the Data Service (db jail), Web Service (cms
|
|
jail), Code Service (git jail), and the Worker environment (worker
|
|
jail).
|
|
</p>
|
|
|
|
<div class="info-box success">
|
|
<span class="info-label">Same steps, different entry point</span>
|
|
<p>
|
|
After boot, the commands in
|
|
<a href="/docs/install.html">Installation</a>
|
|
still apply. The ISO path just gives you a ready-to-run host
|
|
baseline and offline packages.
|
|
</p>
|
|
</div>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>Rust toolchain</h2>
|
|
<p>
|
|
Native dependencies (SWC, tree-sitter) require Rust. Install rustup
|
|
under <code>/opt/clawdie</code> after first boot:
|
|
</p>
|
|
<pre><code>sudo mkdir -p /opt/clawdie/tmp /opt/clawdie/rustup /opt/clawdie/cargo
|
|
sudo fetch -o /opt/clawdie/tmp/rustup-init.sh https://sh.rustup.rs
|
|
sudo env RUSTUP_HOME=/opt/clawdie/rustup CARGO_HOME=/opt/clawdie/cargo \
|
|
sh /opt/clawdie/tmp/rustup-init.sh -y --profile minimal --default-toolchain stable</code></pre>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>Docs on the Web Service</h2>
|
|
<p>
|
|
The Web Service (cms jail) serves the documentation site through
|
|
local nginx. Once the Web Service is up, you can publish it to a
|
|
public domain (for example, <code>docs.<your-domain></code>)
|
|
or keep it internal on the <code>home.arpa</code> namespace until
|
|
exposure is ready.
|
|
</p>
|
|
</section>
|
|
|
|
<div class="divider"></div>
|
|
|
|
<section>
|
|
<h2>Build the ISO yourself</h2>
|
|
<p>
|
|
If you need to customize the package set or embed a specific Clawdie
|
|
version, follow the build instructions in
|
|
<a
|
|
href="https://codeberg.org/Clawdie/Clawdie-ISO"
|
|
target="_blank"
|
|
rel="noopener"
|
|
>Clawdie-ISO</a
|
|
>.
|
|
</p>
|
|
</section>
|
|
</main>
|
|
</div>
|
|
|
|
<footer class="footer">
|
|
<div class="footer-inner">
|
|
<p>Clawdie Docs</p>
|
|
<p>Self-hosted AI on FreeBSD</p>
|
|
</div>
|
|
<div class="footer-hex">△</div>
|
|
</footer>
|
|
|
|
<script>
|
|
const menuBtn = document.getElementById('menuBtn');
|
|
const sidebar = document.getElementById('sidebar');
|
|
const overlay = document.getElementById('overlay');
|
|
if (menuBtn && sidebar) {
|
|
menuBtn.addEventListener('click', () => {
|
|
sidebar.classList.toggle('open');
|
|
overlay?.classList.toggle('open');
|
|
});
|
|
overlay?.addEventListener('click', () => {
|
|
sidebar.classList.remove('open');
|
|
overlay.classList.remove('open');
|
|
});
|
|
}
|
|
</script>
|
|
</body>
|
|
</html>
|