{"id":51370185,"url":"https://github.com/sazid/szos","last_synced_at":"2026-07-03T05:35:27.292Z","repository":{"id":363069287,"uuid":"1261810181","full_name":"sazid/szos","owner":"sazid","description":"Personal bootc based immutable OS","archived":false,"fork":false,"pushed_at":"2026-06-07T08:58:58.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T10:22:07.416Z","etag":null,"topics":["bazzite","bootc","container","fedora-silverblue","podman"],"latest_commit_sha":null,"homepage":"","language":"Just","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sazid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T07:16:02.000Z","updated_at":"2026-06-07T08:59:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sazid/szos","commit_stats":null,"previous_names":["sazid/szos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sazid/szos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazid%2Fszos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazid%2Fszos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazid%2Fszos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazid%2Fszos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sazid","download_url":"https://codeload.github.com/sazid/szos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazid%2Fszos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35074231,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bazzite","bootc","container","fedora-silverblue","podman"],"created_at":"2026-07-03T05:35:26.477Z","updated_at":"2026-07-03T05:35:27.281Z","avatar_url":"https://github.com/sazid.png","language":"Just","funding_links":[],"categories":[],"sub_categories":[],"readme":"# szos\n\nSazid's personal bootc Open Image.\n\nBase image:\n\n```text\nghcr.io/ublue-os/bazzite-gnome-nvidia-open:stable\n```\n\n## Getting Started\n\nStart from an existing bootc-based Bazzite/Universal Blue system, then switch to\nthis image:\n\n```sh\nsudo bootc switch ghcr.io/sazid/szos:latest\nsudo systemctl reboot\n```\n\nAfter reboot, confirm the active image:\n\n```sh\nbootc status\n```\n\nRun the personal setup recipes after login:\n\n```sh\nujust szos-devtools\nujust szos-flatpaks\n```\n\nTo maintain the OS, wait for GitHub Actions to publish a new `latest` image,\nthen upgrade and reboot:\n\n```sh\nsudo bootc upgrade\nsudo systemctl reboot\n```\n\nTo stage and apply the upgrade immediately:\n\n```sh\nsudo bootc upgrade --apply\n```\n\nIf the new deployment has a problem, roll back to the previous one:\n\n```sh\nsudo bootc rollback\nsudo systemctl reboot\n```\n\n## Layout\n\n- `Containerfile`: image entrypoint and host-level RPM customization point.\n- `files/`: root filesystem overlay copied into the image.\n- `files/usr/share/ublue-os/just/60-custom.just`: custom `ujust` recipes.\n- `Justfile`: local build helpers.\n\n## Build Locally\n\n```sh\njust build-local\n```\n\nEquivalent command:\n\n```sh\npodman build --pull=newer -t localhost/szos:latest .\n```\n\n## Publish\n\nCommits pushed to `main` are built by GitHub Actions and published to GHCR:\n\n```text\nghcr.io/\u003cgithub-user\u003e/szos:latest\nghcr.io/\u003cgithub-user\u003e/szos:sha-\u003ccommit\u003e\n```\n\nIf the GHCR package is private, make it public or configure registry auth on the\ntarget machine before switching to it.\n\nYou can also publish manually from your workstation:\n\n```sh\njust push ghcr.io/\u003cgithub-user\u003e szos latest\n```\n\n## Customizing\n\nUse image-level RPM installs only for things that must be in the host OS:\ndrivers, VPN clients, shells, system services, and low-level tools. Prefer\nFlatpak, Homebrew, or Distrobox for regular apps.\n\nUser-space developer tools are bootstrapped after login:\n\n```sh\nujust szos-devtools\n```\n\nThe image includes OpenJDK 25 LTS, Android platform tools (`adb`/`fastboot`),\nNode.js 22/npm, GitHub CLI, Asciinema, Helix, `just`, and a C/C++ build stack\nwith GCC, Clang/LLVM, CMake, Ninja, Make, LLD, LLDB, and `pkg-config`. The\nrecipe verifies those host tools, then installs or updates Rust/Cargo, `uv`,\nCodex, and OpenCode under the current user's home directory.\n\nThe current system Flatpak app set is tracked in\n`files/usr/share/szos/flatpaks.txt` and can be restored after login:\n\n```sh\nujust szos-flatpaks\n```\n\nTo add RPMs, uncomment and edit the package block in `Containerfile`.\n\nTo add files, place them under `files/` with their final paths. For example:\n\n```text\nfiles/etc/containers/registries.conf.d/example.conf\nfiles/usr/local/bin/example-script\nfiles/usr/share/ublue-os/just/60-custom.just\n```\n\nKeep secrets out of this repo. Do not commit `cosign.key`, tokens, SSH keys, or\nmachine-specific private config.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsazid%2Fszos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsazid%2Fszos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsazid%2Fszos/lists"}