https://github.com/centos-workstation/homeserver
CentOS Homeserver appliance with Portainer, Cockpit and ZFS
https://github.com/centos-workstation/homeserver
bootc centos container ostree quadlet quadlets
Last synced: about 1 month ago
JSON representation
CentOS Homeserver appliance with Portainer, Cockpit and ZFS
- Host: GitHub
- URL: https://github.com/centos-workstation/homeserver
- Owner: centos-workstation
- License: apache-2.0
- Created: 2024-12-27T18:44:02.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-17T06:03:39.000Z (2 months ago)
- Last Synced: 2025-04-11T03:06:23.692Z (about 1 month ago)
- Topics: bootc, centos, container, ostree, quadlet, quadlets
- Language: Just
- Homepage:
- Size: 85 KB
- Stars: 12
- Watchers: 3
- Forks: 4
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Home Server
An example of an appliance built with bootc. Designed for your friend who wants a home server with a webui, and tailscale in case they _need you_ to go fix something. 😄 This is based on Universal Blue's [ccos](https://github.com/ublue-os/ccos) base image, which brings in CoreOS features.
- [portainer](https://www.portainer.io/) - to manage containerized applications
- [cockpit](https://cockpit-project.org/) - to manage the system via a webuit and included web terminal
- [tailscale](https://tailscale.com) - for VPN
## Download ISO
- [Download the ISO](https://download.projectbluefin.io/server.iso)
Then follow the installation instructions, remember to set up networking in the installer before continuing with the installation!
## Usage
After first boot:
- `https://:9090` - access the system maintenance webui, login with your username and password.
- `https://:9443` - access the portainer webui
Tailscale is available via the `tailscale` command.
## TODO (PRs welcomed!)
- Let's Encrypt setup
- Magical DNS things to make it easy to run as a home server
## Reference Material
- https://developers.redhat.com/articles/2025/01/21/how-image-mode-rhel-simplifies-software-appliances#
## Build ISO
Clone this repo then run this to build an iso:
```
sudo podman run --rm -it --privileged --pull=newer --net=host --security-opt label=type:unconfined_t -v $(pwd)/image-builder-iso.config.toml:/config.toml:ro -v $(pwd)/output:/output -v /var/lib/containers/storage:/var/lib/containers/storage ghcr.io/centos-workstation/bootc-image-builder:latest --type anaconda-iso ghcr.io/centos-workstation/homeserver
```