{"id":13645911,"url":"https://github.com/stellarproject/terraos","last_synced_at":"2026-03-04T23:31:17.543Z","repository":{"id":140493930,"uuid":"178043768","full_name":"stellarproject/terraos","owner":"stellarproject","description":"New way to think about distros","archived":false,"fork":false,"pushed_at":"2019-11-18T15:34:02.000Z","size":72698,"stargazers_count":14,"open_issues_count":5,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-10T07:03:12.012Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://stellarproject.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stellarproject.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}},"created_at":"2019-03-27T17:30:35.000Z","updated_at":"2024-04-25T05:42:57.000Z","dependencies_parsed_at":"2024-01-14T09:57:59.687Z","dependency_job_id":null,"html_url":"https://github.com/stellarproject/terraos","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/stellarproject/terraos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellarproject%2Fterraos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellarproject%2Fterraos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellarproject%2Fterraos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellarproject%2Fterraos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stellarproject","download_url":"https://codeload.github.com/stellarproject/terraos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellarproject%2Fterraos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30099340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T22:49:54.894Z","status":"ssl_error","status_checked_at":"2026-03-04T22:49:48.883Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-08-02T01:02:44.810Z","updated_at":"2026-03-04T23:31:17.522Z","avatar_url":"https://github.com/stellarproject.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Terra OS\n\n![terra](pxe/splash.png)\n\nModern, minimal operating system (we've heard that before) optimized for containers within the Stellar Project.\n\nTerra is an OS not a distro, we use the best distribution for the job, and that's an Ubuntu base.\n\nThis repo is a mono repo for most, if not all terra \u0026\u0026 stellar projects.\n\n## Status\n\n**Project Status:** alpha\n\n* alpha - APIs will change, not ready services.\n* beta - APIs may change, can run services.\n* production - APIs stable, can run services.\n\n\n## Build Terra\n\nIf you don't have a kernel built then do so first:\n\n```bash\n\u003e make kernel\n```\n\nNow build the terra base images and components:\n\n```bash\n\u003e make release\n```\n\nTo make the terra binaries locally and install them do:\n\n```bash\n\u003e make local \u0026\u0026 sudo make install\n```\n\n## Installation\n\n### PXE\n\nFor running in a PXE environment terra has a controller with `tftp` and `iscsi` support.\n\nTo install the files for PXE run:\n\n```bash\n\u003e sudo terra -r registry.compute:5000 --http pxe install\n```\n\nTo save your node image in pxe run:\n\n```bash\n\u003e terra pxe save server.toml\n```\n\nThis will generate the pxe config for the node's information.\n\n### Disk\n\nMake sure you have a disk partitioned with one partition when installing terra.\nYou need to have this done before using the terra command to install the image to the device.\nUse `fdisk` here to do so.\n\nTo install your image onto a disk, run the following.\n\nTo install onto an iscsi volume:\n\n```bash\n\u003e sudo terra -r registry.compute:5000 --http  install --os /dev/sdb1\n```\n\nIf you have a separate data LUN use `--data \u003cdevice\u003e` for it.\n\nYou will need to save the nodes PXE config with the `save` config.\n\n## Boot\n\nNow boot your node and PXE will take care of the rest.\n\n## License\n\n```\nCopyright (c) 2019 Stellar Project\n\nPermission is hereby granted, free of charge, to any person\nobtaining a copy of this software and associated documentation\nfiles (the \"Software\"), to deal in the Software without\nrestriction, including without limitation the rights to use, copy,\nmodify, merge, publish, distribute, sublicense, and/or sell copies\nof the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED,\nINCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\nHOLDERS BE LIABLE FOR ANY CLAIM,\nDAMAGES OR OTHER LIABILITY,\nWHETHER IN AN ACTION OF CONTRACT,\nTORT OR OTHERWISE,\nARISING FROM, OUT OF OR IN CONNECTION WITH\nTHE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellarproject%2Fterraos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstellarproject%2Fterraos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellarproject%2Fterraos/lists"}