Shadowfetch Linux 5.0.1 «Umbra»

Documentation

27 guides, covering installation, verification, hardware and Secure Boot, project workspaces, the security model, the known issues and the release history. Each page separates what the system does today from what is planned.

Get it running

From nothing installed to a working desktop.

  • ShadowCode https://shadowcode.org/

    The coding agent preinstalled in 5.0: one picker for your subscriptions, OpenRouter key or local models, approvals and diff review, and how the signed .deb is verified into the image.

  • Grok Bot /grok-bot

    Install Grok Bot on Linux: the official native desktop as an optional Welcome agent, verified installation, and cloud account sign-in.

  • Mission Control /mission-control

    Create scoped code, source-report and media missions; inspect activity, files, changes and recovery.

  • Overview /

    What Shadowfetch Linux is: a Debian testing and KDE Plasma 6 desktop built around ShadowCode, with inspectable agent sandboxes and signed downloads.

  • Screenshots /screenshots

    Captures of the signed 5.0 ISO: the desktop, Welcome, ShadowCode, Mission Control, the installer and the boot and login screens.

  • Download /download

    The ISO, its exact size, the checksum and signature, resuming a large download, and how to write it to a USB stick.

  • Verify /verify

    Confirm the SHA-256 checksum and the GPG signature on Linux, macOS or Windows before you install.

  • Install /install

    Boot the ISO, review Calamares partitioning and encryption, reboot, and follow the first-boot notes.

  • APT repository /apt

    The signed repository (suite umbra, component main, amd64) for adding Shadowfetch packages to an existing Debian system.

  • Workspaces /workspaces

    Workbench profiles, project folders under ~/Workspaces, the agent network setting and offline media workflows.

  • Local models /local-ai

    Models that run on this computer: ShadowCode's bundled llama.cpp runtime, and Mission Control's on-device provider, which needs a model service you supply.

  • Historical local AI benchmarks /benchmarks

    Measured tokens-per-second and VRAM fit on the studio RTX 5060 Ti (16 GB).

Hardware and boot

What it runs on, and the one firmware setting that stops it.

Know the limits

Read this before installing on a machine you depend on.

Reference

Answers, history, licensing, privacy.

  • FAQ /faq

    Direct answers on the Debian relationship, who it suits, NVIDIA, which workflows need online access, and verifying the ISO.

  • Changelog /changelog

    The release history, and what changed in each one.

  • Licensing & source /licensing

    Upstream licenses, the license Shadowfetch's own components carry, and the written offer for corresponding source.

  • Privacy /privacy

    What this website records (PostHog analytics, Cloudflare Web Analytics, the download and install counts, Cloudflare logs) and that the OS sends no telemetry.

  • Support the project /donate

    Shadowfetch Linux is free and stays free. There is a tip jar, with no tiers, perks or gated features.

  • Open source /open-source

    Studio projects that do not ship in the ISO, plus public GitHub and Hugging Face directories, with the ranking rules.