{"id":22968247,"url":"https://github.com/fyralabs/submarine","last_synced_at":"2025-07-21T00:34:08.285Z","repository":{"id":211757627,"uuid":"726288171","full_name":"FyraLabs/submarine","owner":"FyraLabs","description":"An experimental bootloader for ChomeOS's depthcharge","archived":false,"fork":false,"pushed_at":"2025-04-23T02:28:36.000Z","size":214,"stargazers_count":60,"open_issues_count":4,"forks_count":7,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-07-19T05:29:28.770Z","etag":null,"topics":["bootloader","chromeos","linux"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FyraLabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"github":"FyraLabs"}},"created_at":"2023-12-02T00:24:45.000Z","updated_at":"2025-07-01T10:54:10.000Z","dependencies_parsed_at":"2024-01-08T21:54:08.723Z","dependency_job_id":"37eea0a2-3269-4f95-887c-3533ee722eb4","html_url":"https://github.com/FyraLabs/submarine","commit_stats":null,"previous_names":["fyralabs/submarine"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/FyraLabs/submarine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FyraLabs%2Fsubmarine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FyraLabs%2Fsubmarine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FyraLabs%2Fsubmarine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FyraLabs%2Fsubmarine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FyraLabs","download_url":"https://codeload.github.com/FyraLabs/submarine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FyraLabs%2Fsubmarine/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266221394,"owners_count":23894966,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bootloader","chromeos","linux"],"created_at":"2024-12-14T21:16:47.912Z","updated_at":"2025-07-21T00:34:08.269Z","avatar_url":"https://github.com/FyraLabs.png","language":"Makefile","readme":"\u003c!-- \u003cimg align=\"left\" style=\"vertical-align: middle\" width=\"120\" height=\"120\" alt=\"Skiff Icon\" src=\"data/icons/app.svg\"\u003e --\u003e\n\n# Submarine\n\nAn experimental bootloader for ChomeOS's depthcharge.\n\n\u003e [!WARNING]  \n\u003e Submarine is currently beta software. Please exercise care with your system and report any issues you encounter.\n\n## 📕 Explainer\n\nSubmarine provides a minimal Linux environmemt that lives in a small partition (16mb) on the disk. We use this environment to bootstrap a full Linux system (or a different system if you're brave.)\n\n[Additional documention can be found on Fyra Developer (under construction!)](https://developer.fyralabs.com/submarine)\n\n## 📦 Builds\n\nWe offer prebuilt versions of the images per each commit:\n\n- [Latest x86_64 build](https://nightly.link/FyraLabs/submarine/workflows/build/main/submarine-x86_64.zip)\n- [Latest arm64 build](https://nightly.link/FyraLabs/submarine/workflows/build/main/submarine-arm64.zip)\n\n## 🛠️ Dependencies\n\nPlease make sure you have these dependencies first before building.\n\n```bash\nmake\ngcc\nccache\nflex\nbison\nelfutils-devel\nparted\nvboot-utils\ngolang\nxz\nbc\ntar\nopenssl-devel\npython3-pip\nuboot-tools\n```\n\nAdditionally, you'll need to install `u-root` and `depthcharge-tools` (if you have the [Terra repository](https://terra.fyralabs.com/), you can `dnf install` them). \nTo install the latest versions:\n\n```bash\ngo install github.com/u-root/u-root@latest\npip3 install depthcharge-tools\n```\n\nLastly, you may need to install a cross-compile gcc. For example:\n\n```bash\ngcc-aarch64-linux-gnu\n```\n\n## 🏗️ Building\n\nSimply clone this repo with submodules, so pass `--recurse-submodules` to `git clone`, then:\n\n```bash\nmake -j$(nproc) \u003cx86_64|arm64\u003e\n```\n\nPlease note that you **must** pass an architecture target.\n\nThe build output is located in `build/`.\nFor testing, an image is built at `build/submarine.bin` which you can directly flash onto an external drive.\nSo, for example, replace `/dev/sdX` with the device file of the external drive:\n\n```bash\nsudo dd if=build/submarine.bin of=/dev/sdX\n```\n\n## 🗒️ Todos\n\n- Clean up kernel configs\n","funding_links":["https://github.com/sponsors/FyraLabs"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffyralabs%2Fsubmarine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffyralabs%2Fsubmarine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffyralabs%2Fsubmarine/lists"}