Meta tags:
description=Your personal Gentoo deployment. Contribute to lxnay/matrixos development by creating an account on GitHub.;

Headings (most frequently used words):

build, navigation, to, matrixos, and, files, available, keys, installation, management, contributing, footer, option, vector, welcome, menu, latest, commit, history, folders, repository, table, of, contents, disambiguation, disclaimer, features, prerequisites, desktops, images, system, your, own, distro, known, issues, roadmap, milestones, license, about, releases, packages, used, by, contributors, languages, public, flash, drive, install, from, post, setup, secureboot, command, reference, upgrades, rollbacks, branch, switching, mutability, jailbreaking, customization, directories, configuration, rules, resource, workflow, commands, gnome, fractional, scaling, nvidia, drivers, nouveau, fight, milestone, future, resources, stars, watchers, forks,

Text of the page (most frequently used words):
the (56), vector (52), and (45), #matrixos (28), build (28), for (25), branch (25), you (20), all (20), sudo (19), with (18), ostree (16), your (15), github (13), dev (13), system (13), security (12), code (12), run (12), this (11), conf (11), available (11), boot (11), deployment (10), images (10), are (10), gnome (10), image (10), switch (10), from (9), release (9), license (8), keys (8), branches (8), contributing (7), gentoo (7), support (7), list (7), secureboot (7), view (7), can (6), first (6), full (6), features (6), set (6), cpu (6), command (6), update (6), upgrade (6), jailbreak (6), local (6), show (6), password (6), desktop (6), drive (6), enterprise (6), that (5), add (5), issues (5), script (5), key (5), using (5), seeder (5), settings (5), install (5), services (5), cosmic (5), use (5), installation (5), remote (5), date (5), mok (5), not (4), community (4), navigation (4), repository (4), readme (4), resources (4), builds (4), tools (4), user (4), commands (4), new (4), kargs (4), nouveau (4), nvidia (4), enable (4), resource (4), name (4), force (4), parallelism (4), default (4), gpg (4), configuration (4), process (4), partition (4), bootloader (4), amd64 (4), files (4), into (4), pin (4), unpin (4), latest (4), luks (4), flash (4), signed (4), docker (4), type (4), another (4), actions (4), quality (4), personal (3), manage (3), releases (3), stars (3), bsd (3), clause (3), linux (3), direct (3), most (3), milestone (3), drivers (3), only (3), scaling (3), x86 (3), any (3), values (3), friendly (3), get (3), description (3), stages (3), specific (3), root (3), via (3), when (3), each (3), management (3), fork (3), configs (3), releaser (3), imager (3), directories (3), base (3), scripts (3), setup (3), hooks (3), provided (3), immutable (3), directly (3), mutable (3), once (3), updates (3), before (3), deployments (3), booted (3), upgrades (3), kernel (3), setupos (3), pull (3), atomic (3), file (3), shim (3), hardware (3), uefi (3), two (3), will (3), guid (3), matrix (3), matrixos_amd64_gnome (3), img (3), sha256 (3), commits (3), source (3), desktops (3), environments (3), prerequisites (3), steam (3), flatpak (3), out (3), more (3), software (3), commit (3), open (3), insights (3), tab (3), window (3), refresh (3), session (3), reload (3), sign (3), grade (3), copilot (3), platform (3), solutions (3), explore (3), status (2), footer (2), used (2), packages (2), forks (2), org (2), party (2), under (2), see (2), power (2), cli (2), bootc (2), welcome (2), tooling (2), progress (2), facing (2), roadmap (2), milestones (2), blacklist (2), driver (2), fractional (2), known (2), 32gb (2), requirements (2), flags (2), print (2), config (2), lines (2), value (2), cfg (2), verify (2), host (2), has (2), required (2), artifacts (2), enter (2), single (2), also (2), resume (2), workflow (2), limits (2), cgroups (2), cores (2), useful (2), maximum (2), across (2), workers (2), worker (2), gets (2), maxcores (2), maxmemorygib (2), supports (2), control (2), important (2), paths (2), architecture (2), repositories (2), project (2), client (2), creation (2), etc (2), running (2), different (2), custom (2), own (2), distro (2), standard (2), warning (2), emerge (2), readwrite (2), mutability (2), reboot (2), between (2), currently (2), rollbacks (2), skip (2), arguments (2), entries (2), karg (2), idx (2), wizard (2), passwords (2), ssh (2), deploy (2), reference (2), enroll (2), then (2), enrollment (2), bios (2), allows (2), trust (2), encryption (2), after (2), following (2), target (2), usb (2), formats (2), option (2), must (2), change (2), these (2), immediately (2), 1000 (2), download (2), compressed (2), fingerprint (2), public (2), cloudflare (2), avx2 (2), fma (2), snap (2), includes (2), box (2), comes (2), disclaimer (2), based (2), distribution (2), shipping (2), disambiguation (2), integration (2), amd (2), our (2), gaming (2), reliability (2), main (2), sum (2), mod (2), todo (2), gitignore (2), screenshots (2), pubkeys (2), last (2), message (2), 219 (2), menu (2), projects (2), discussions (2), requests (2), lxnay (2), appearance (2), business (2), advanced (2), developer (2), topics (2), customer (2), documentation (2), devops (2), app (2), merge (2), perform, action, time, share, information, cookies, contact, docs, privacy, terms, 2026, inc, languages, contributors, report, watching, watchers, activity, about, released, text, third, applications, retain, their, respective, licenses, simplified, please, donate, donations, mirrors, repo, compute, helping, migration, improving, contributions, migrate, wrapper, top, uki, moving, away, usage, implement, proper, pipelines, testing, rewrite, core, migrated, future, current, focus, technologies, friendliness, modprobe, loads, despite, being, present, fight, gsettings, mutter, experimental, scale, monitor, framebuffer, offers, 100, 200, ram, 70gb, disk, help, test, generated, qemu, data, check, clean, janitor, chroot, seeding, stage, seeds, provides, access, individual, steps, handles, entire, pipeline, enforced, oversubscription, multiplier, allow, overlapping, cpuset, ranges, load, asymmetric, soft, coresmultiplier, total, memory, gib, number, seed, concurrently, setting, parallel, fine, grained, section, customize, point, gitrepo, component, lead, here, logs, downloads, output, git, info, centralized, side, reads, rules, follow, pattern, osname, arch, seeder_name, note, systemd, disable, mask, contains, layers, subdirectory, defining, layer, server, bedrock, seeders, customization, versions, respectively, however, want, modify, compile, kernels, portage, converts, cannot, back, automatic, responsible, maintaining, yourself, one, way, permanent, resets, much, like, doing, temporary, jailbreaking, interactively, them, switching, fails, simply, previous, entry, preview, without, applying, prompts, binaries, even, pretend, remove, ref, previously, pinned, preserve, permanently, convert, temporarily, make, until, next, block, device, quick, uses, require, manager, itself, microsoft, 2011, 2023, allowing, validates, subsequent, machine, owner, der, firmware, authorized, signature, cert, pem, ways, systemctl, now, regenerate, configure, terminal, post, 4f68bce3, e8cd, 4db1, 96e7, fbcaf984b709, 8304, bc13c2ff, 59e6, 4262, a352, b275fd6f7172, ea00, c12a7328, f81f, 11d2, ba4b, 00a0c93ec93b, ef00, esp, partitioning, manually, layout, strict, adherence, wipe, stick, onto, built, installer, partitions, copies, defaults, above, publicly, documented, left, place, passphrase, connecting, network, credentials, encrypted, matrixos2026enc, uid, there, users, sha256sum, sdx, conv, sparse, fsync, its, similar, dc474f4cbd1d3260d9cc6d9275dd33e282be47ce, authenticity, flashing, trusted, qcow2, raw, system76, tested, notes, ships, separate, least, 64gb, recommended, ssd, nvme, storage, x86_64, avx, bmp1, appimage, apps, easy, certificates, zstd, compression, auto, resizing, ntfsplus, btrfs, filesystem, liquidctl, coolercontrold, cooling, mesa, graphics, hobby, created, homelab, setups, intended, mission, critical, production, everything, warranty, need, entropy, world, operating, defined, controllers, debian, trinity, coding, table, contents, requires, intel, haswell, 2013, ryzen, series, older, fail, details, requirement, motto, everywhere, loader, lutris, optimizations, both, gpus, minimal, fuss, providing, stable, through, which, goals, ready, blends, customizability, leverages, provide, guarantees, ensuring, applied, entirely, remains, read, prevent, accidental, damage, immutability, atomicity, items, folders, history, tags, additional, options, star, notification, notifications, dismiss, alert, switched, accounts, search, pricing, premium, ons, powered, collections, trending, archive, program, accelerator, maintainer, lab, programs, fund, developers, sponsors, partners, center, forum, skills, ebooks, reports, events, webinars, stories, development, topic, industries, government, manufacturing, financial, healthcare, industry, cases, devsecops, modernization, case, nonprofits, startups, small, medium, teams, enterprises, company, size, marketplace, changelog, blog, why, stop, leaks, they, start, secret, protection, secure, find, fix, vulnerabilities, application, enforce, changes, review, plan, track, work, instant, codespaces, automate, workflows, integrate, external, mcp, registry, agents, issue, write, better, content,

Text of the page (random words):
github lxnay matrixos your personal gentoo deployment github skip to content navigation menu sign in appearance settings platform ai code creation github copilot write better code with ai github copilot app direct agents from issue to merge mcp registry integrate external tools developer workflows actions automate any workflow codespaces instant dev environments issues plan and track work code review manage code changes code quality enforce quality at merge application security github advanced security find and fix vulnerabilities code security secure your code as you build secret protection stop leaks before they start explore why github documentation blog changelog marketplace view all features solutions by company size enterprises small and medium teams startups nonprofits by use case app modernization devsecops devops ci cd view all use cases by industry healthcare financial services manufacturing government view all industries view all solutions resources explore by topic ai software development devops security view all topics explore by type customer stories events webinars ebooks reports business insights github skills support services documentation customer support community forum trust center partners view all resources open source community github sponsors fund open source developers programs security lab maintainer community accelerator github stars archive program repositories topics trending collections enterprise enterprise solutions enterprise platform ai powered developer platform available add ons github advanced security enterprise grade security features copilot for business enterprise grade ai features premium support enterprise grade 24 7 support pricing search sign in sign up appearance settings you signed in with another tab or window reload to refresh your session you signed out in another tab or window reload to refresh your session you switched accounts on another tab or window reload to refresh your session dismiss alert message lxnay matrixos public notifications you must be signed in to change notification settings fork 8 star 66 code issues 1 pull requests 1 discussions actions projects security and quality 0 insights additional navigation options code issues pull requests discussions actions projects security and quality insights main branches tags go to file code open more actions menu latest commit history 2 219 commits 2 219 commits folders and files name name last commit message last commit date github github build build conf conf dev dev image image pubkeys ostree gpg pubkeys ostree gpg release release screenshots screenshots vector vector gitignore gitignore matrixos matrixos contributing md contributing md license license readme md readme md todo todo go mod go mod go sum go sum view all files repository files navigation readme contributing bsd 2 clause license more items welcome to matrixos matrixos is a gentoo based linux distribution that blends the power and customizability of gentoo with the reliability of ostree atomic upgrades it leverages ostree to provide atomicity and immutability guarantees ensuring that updates are applied entirely or not at all and the base system remains read only to prevent accidental damage it comes with flatpak snap and docker ready to go out of the box our two main goals are reliability providing a stable immutable base system through ostree which allows for atomic upgrades and rollbacks gaming friendly shipping with the steam loader lutris and optimizations to get you gaming on both nvidia and amd gpus with minimal fuss and our motto is emerge once deploy everywhere tl dr download from cloudflare cpu requirement matrixos requires an x86 64 v3 cpu avx2 fma intel haswell 2013 or amd ryzen 1000 series older hardware will fail to boot see prerequisites for details table of contents disambiguation disclaimer features prerequisites available desktops available images keys installation system management build your own distro known issues roadmap milestones contributing license gnome desktop w steam and gnome software system os and flatpak integration ostree integration coding and ai ️ disambiguation the og matrixos a debian based distribution shipping with trinity desktop matrixos an operating system for software defined controllers we need more entropy in this world ️ disclaimer matrixos is a hobby project created for homelab setups it is not intended for mission critical production environments everything in this repository is provided as is and comes with no warranty features graphics latest mesa and nvidia drivers out of the box cooling includes coolercontrold and liquidctl filesystem btrfs on boot and with zstd compression auto resizing on first boot includes ntfsplus driver security uefi secureboot support with easy to install certificates apps steam flatpak snap appimage and docker available immediately prerequisites hardware requirements architecture x86_64 amd64 with x86 64 v3 support avx avx2 bmp1 2 fma etc storage at least 32gb 64gb recommended on usb ssd nvme ️ available desktops matrixos ships the following desktop environments as separate ostree branches desktop branch notes gnome matrixos amd64 dev gnome default and most tested cosmic matrixos amd64 dev cosmic system76 cosmic desktop switch between desktops with sudo vector branch switch and reboot available images keys images are available in raw for flashing and qcow2 for vm formats compressed with xz trusted source cloudflare public keys use these keys to verify the authenticity of images and commits gpg ostree images dc474f4cbd1d3260d9cc6d9275dd33e282be47ce secureboot fingerprint sha256 fingerprint 38 02 d7 fc a7 6f 08 04 9c 7f d5 d7 af 9a 24 6c 9b c2 28 f3 45 99 7b df 79 ee f3 35 0a 81 87 1b installation option 1 flash to drive download the image compressed with xz and its sha256 file then flash it to your target drive using dd or similar tools sha256sum c matrixos_amd64_gnome date img xz sha256 xz d matrixos_amd64_gnome date img xz dd if matrixos_amd64_gnome date img of dev sdx bs 4m status progress conv sparse fsync there are two default users root password matrix matrix uid 1000 password matrix luks password if encrypted matrixos2026enc ️ change these credentials immediately the defaults above are publicly documented and must not be left in place run sudo vector setupos after first boot to set new passwords and a luks passphrase before connecting to any network option 2 install from matrixos once booted into matrixos e g from a usb stick you can install it onto another drive using the built in installer it partitions your drive formats it and copies the running system to the new drive warning this will wipe the target drive sudo vector flash if you are partitioning manually strict adherence to the following layout is required esp partition type ef00 guid c12a7328 f81f 11d2 ba4b 00a0c93ec93b boot partition type ea00 guid bc13c2ff 59e6 4262 a352 b275fd6f7172 partition type 8304 guid 4f68bce3 e8cd 4db1 96e7 fbcaf984b709 post installation setup after your first boot run the setup wizard to configure your system run this from a vt or desktop terminal sudo vector setupos this will set the root password set the user password set the luks encryption password if you used encryption regenerate ssh host keys for security to enable docker systemctl enable now docker secureboot matrixos supports secureboot you can set it up in two ways uefi bios enrollment enroll the matrixos secureboot cert pem directly into your uefi bios as an authorized signature db this allows the firmware to trust the matrixos bootloader and kernel directly shim mok enrollment use the provided matrixos secureboot mok der file to enroll a machine owner key mok via the shim mok manager at first boot the shim itself is signed by microsoft 2011 and 2023 allowing it to run on most hardware and it then validates subsequent stages using the mok ️ system management matrixos uses ostree for atomic updates all system commands require sudo vector command reference a quick reference of all user facing vector commands command description vector upgrade pull and deploy the latest os update vector flash install matrixos to a block device vector setupos first boot wizard passwords luks ssh keys vector readwrite temporarily make the os mutable until next upgrade vector jailbreak permanently convert to a standard mutable gentoo system vector branch show show the currently booted deployment vector branch deployment show all local deployments vector branch pin idx pin a deployment to preserve it vector branch unpin idx unpin a previously pinned deployment vector branch remote list remote branches available vector branch local list local branches vector branch switch ref switch to a different os branch vector kargs add karg add kernel arguments to all boot entries vector kargs rm karg remove kernel arguments from all boot entries vector cfg get key print config values as key value lines script friendly upgrades update to the latest image sudo vector upgrade useful flags pretend preview without applying y skip prompts update bootloader update bootloader binaries force upgrade even if up to date rollbacks if an update fails simply boot into the previous entry ostree 1 to manage deployments sudo vector branch show show the currently booted deployment sudo vector branch deployment show all local deployments sudo vector branch pin 1 pin deployment 1 sudo vector branch unpin 1 unpin deployment 1 branch switching list available branches and switch between them e g from gnome to cosmic sudo vector branch remote list remote branches available sudo vector branch local list local branches sudo vector branch switch interactively switch to a new branch reboot mutability jailbreaking temporary mutability sudo vector readwrite resets on upgrade so that you can run emerge as much as you like important switch to a full ostree branch before doing this permanent jailbreak matrixos is immutable by default however if you want full control to modify system files compile custom kernels or use portage directly you can jailbreak the system this converts your immutable ostree installation into a standard mutable gentoo linux installation warning this is a one way process once you jailbreak you cannot go back to automatic ostree updates you are responsible for maintaining the system yourself list available branches sudo vector branch remote switch to the full branch sudo vector branch switch branch full run the jailbreak script sudo vector jailbreak ️ build your own distro you can build custom versions of matrixos using the provided dev build sh script the build process is seeder releaser imager respectively the directories are build for seeder release for releaser and image for imager customization directories build seeders contains the build layers 00 bedrock 10 server 20 gnome 21 cosmic each subdirectory has scripts configs defining packages and settings for that layer release configuration for the release process hooks scripts running at different release stages services systemd services to enable disable mask note hooks and services follow the osname arch seeder_name sh conf pattern e g matrixos amd64 gnome sh for branch specific configs image configuration for the image creation process hooks scripts for partition setup bootloader install etc configuration rules the base configuration is centralized in conf matrixos conf vector client side tooling also reads from conf client conf e g the upgrade command project info os name architecture git repositories paths directories for logs downloads and output artifacts keys paths to gpg and secureboot keys lead here component settings specific configs for seeder releaser and imager important if you fork this repository to customize builds update gitrepo in conf matrixos conf to point to your fork build resource management the seeder supports parallel builds with fine grained resource control via conf matrixos conf under the seeder section setting default description parallelism 2 number of seed builds to run concurrently maxmemorygib 0 all maximum total memory gib across all workers each worker gets maxmemorygib parallelism maxcores 0 all maximum cpu cores across all workers each worker gets maxcores parallelism coresmultiplier 1 0 cpu cores oversubscription multiplier values 1 0 allow overlapping cpuset ranges useful when build load is asymmetric or when using cgroups with soft cpu limits resource limits are enforced via cgroups v2 when parallelism 1 build workflow run the build script as root it handles the entire pipeline dev build sh resume dev build sh resume force specific steps force release force images only images vector build commands the vector cli also provides direct access to individual build stages command description vector build seeds run the seeding stage vector build release run a single release vector build releases run all releases vector build image build a single image vector build images build all images vector dev enter name enter a build chroot vector dev janitor clean up build artifacts vector dev check verify host has required tools data vector dev vm test a generated image with qemu vector cfg get key print config values as key value lines script friendly for a full list of flags on any command run vector command help resource requirements x86 64 v3 cpu 32gb ram 70gb disk ️ known issues gnome fractional scaling if gnome only offers 100 or 200 scaling enable fractional scaling gsettings set org gnome mutter experimental features scale monitor framebuffer nvidia drivers and nouveau fight if nouveau loads despite nvidia drivers being present sudo vector kargs add modprobe blacklist nouveau sudo vector kargs add rd driver blacklist nouveau roadmap milestones the current focus is on user friendliness milestone 3 and new technologies milestone 4 milestone 4 future rewrite core tooling in go vector in progress most user facing commands migrated implement proper ci cd pipelines and testing migrate to bootc or wrapper on top of ostree uki support moving away from direct ostree usage contributing contributions are welcome code helping with the migration to bootc or improving cli tools resources mirrors for images ostree repo and compute power for builds donations please donate to gentoo linux license first party code is released under the bsd 2 clause simplified license see license for the full text third party applications retain their respective licenses about your personal gentoo deployment matrixos org resources readme bsd 2 clause license contributing contributing activity stars 66 stars watchers 1 watching forks 8 forks report repository releases packages used by contributors languages footer 2026 github inc footer navigation terms privacy security status community docs contact manage cookies do not share my personal information you can t perform that action at this time