{"id":18576194,"url":"https://github.com/deuill/coreos-home-server","last_synced_at":"2025-10-29T09:46:56.204Z","repository":{"id":45682016,"uuid":"329369023","full_name":"deuill/coreos-home-server","owner":"deuill","description":"Home Server Setup with CoreOS","archived":false,"fork":false,"pushed_at":"2025-07-17T07:42:43.000Z","size":1065,"stargazers_count":68,"open_issues_count":5,"forks_count":6,"subscribers_count":3,"default_branch":"trunk","last_synced_at":"2025-07-17T15:45:13.676Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","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/deuill.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}},"created_at":"2021-01-13T16:36:27.000Z","updated_at":"2025-07-17T03:14:29.000Z","dependencies_parsed_at":"2023-02-01T03:01:19.949Z","dependency_job_id":"a6d7dbff-fbaf-4891-b668-ffbdc2d5440f","html_url":"https://github.com/deuill/coreos-home-server","commit_stats":{"total_commits":745,"total_committers":2,"mean_commits":372.5,"dds":0.3677852348993289,"last_synced_commit":"e8b4575977c4143b8860318d87ce4b0bc4989406"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deuill/coreos-home-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deuill%2Fcoreos-home-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deuill%2Fcoreos-home-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deuill%2Fcoreos-home-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deuill%2Fcoreos-home-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deuill","download_url":"https://codeload.github.com/deuill/coreos-home-server/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deuill%2Fcoreos-home-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266076421,"owners_count":23872752,"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":[],"created_at":"2024-11-06T23:23:56.983Z","updated_at":"2025-10-29T09:46:51.163Z","avatar_url":"https://github.com/deuill.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CoreOS Home Server Setup\n\nThis repository contains support files for deploying a simple server setup based on Fedora CoreOS,\nand mainly based around [systemd](https://systemd.io) and [Podman](https://podman.io).\n\n## Prerequisites\n\nEffective use of the source-files here requires that you have the following dependencies installed\non your host:\n\n  - `gpg` for secret management and image validation.\n  - `butane` for rendering out host and service configuration.\n  - `qemu` for virtual host testing.\n\nAll of the requirements are checked during the various Makefile invocations, and will return fatal\nerrors unless fulfilled. In addition to the aforementioned build-time dependencies, the build host\nneeds the following setup procedures performed:\n\n### Import GPG key for image validation:\n\nThis is required for validating the signatures for installation media when deploying bare-metal and\nvirtual hosts:\n\n```sh\ncurl -fL https://getfedora.org/static/fedora.gpg | gpg --import\n```\n\n## Setup and Deployment\n\nInitial server deployment is managed by the included Makefile, which also allows for testing against\na virtualized environment. Configuration for virtual and physical servers is managed by [Fedora\nCoreOS configuration](https://coreos.github.io/butane/) (*aka* Butane) files, which will typically\ndefine host-specific configuration, and merge in additional, standard configuration; check the\n[virtual host configuration](host/virtual/spec.bu) for an example.\n\nYou can prepare host configuration for consumption by using the `deploy` target for the included\nMakefile, e.g.:\n\n```\nmake deploy HOST=example\n```\n\nThis will compile the host-specific `host/example/spec.bu` file to its corresponding Ignition format\nvia the `butane` utility (which is expected to be installed on the system), and serve the final\nresult over HTTP on the local network. This, of course, assumes that you'll be installing on [bare\nmetal](https://docs.fedoraproject.org/en-US/fedora-coreos/bare-metal/) on a system on your local\nnetwork -- support for additional targets may be added in the future.\n\n## Testing\n\nA virtual host is included for development and testing; using this requires that you have `qemu`\ninstalled on your system. Using the virtual environment is simple:\n\n```\nmake deploy HOST=virtual\n```\n\nThis will automatically download the Fedora CoreOS image for the `VERSION` specified in the\nMakefile, compile included Butane files, and start a virtual machine on the terminal running the\n`make` command. If you want to see the various command run under the hood, add the `VERBOSE=1`\nparameter to the `make` invocation.\n\nBy default, you can use the `\u003cCtrl\u003ea x` key-combination to escape the virtual machine, and can use the\n`\u003cCtrl\u003ea h` key-combination to get additional options related to the current virtual session.\n\n## Included Services\n\nIn addition to host-specific configuration, servers will typically include a number of services,\nmanaged by `systemd` and `podman`. These are intended to be deployed via Ignition on server setup,\nbut also be managed throughout the server's life-cycle.\n\nCheck the [service documentation](service/README.md) for more information.\n\n## License\n\nAll code in this repository is covered by the terms of the MIT License, the full text of which can be found in the LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeuill%2Fcoreos-home-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeuill%2Fcoreos-home-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeuill%2Fcoreos-home-server/lists"}