Show Fedora: A simple, testable home-server setup with CoreOS

Hello all!

After lurking for a while and having been helped out quite a bit by discussions here, I wanted to share a CoreOS-based home-server setup I’ve had working for the past couple of months – this is still largely undocumented and has some rough edges, but hopefully may have enough breadth to be useful to someone.

Github: GitHub - deuill/coreos-home-server: Home Server Setup with CoreOS

The basic theory behind this is quite simple: use CoreOS and Butane to set up a bare-metal host (though this will extend to remote/VPS setups), and install user-defined configuration into /etc/coreos-home-server, and systemd services into /etc/systemd/system. These systemd services will then build containers, run these under Podman, and ensure that all related infrastructure (volumes, networks, etc.) are set up correctly.

File structure is split as follows:

  • hosts/<name> is the “entrypoint” Butane file, used to include any host-specific configuration as well as any services deployed to the host.
  • config/common contains configuration commonly used by hosts, such as base systemd services for managing Podman containers, volumes, and the like.
  • config/service contains configuration for services deployed to hosts. Hosts can include any and all of these, and currently these cover functionality such as a mail server (Postfix, Dovecot, and Rspamd), XMPP server (Prosody), a MariaDB and Redis setup shared among other services, etc.

Included alongside bare-metal hosts is a special “virtual” host, which is used to integration test on a local QEMU-based setup. All of this is tied together by a Makefile, which will ensure that Butane files are included and re-built as needed, and that can serve compiled host configuration over a one-time HTTP server, for use in setting up bare-metal hosts on a local network.

Secrets are currently handled as GPG-encrypted environment files at rest, transmitted to hosts unencrypted and stored with root-only permissions – not ideal, but it’s simple and allows for using the same files in both systemd services and Podman containers. It’s exciting to see native supports for secrets in Podman and Buildah, though, so we’ll see how this pans out.

There’s still a bit of work to do but I’m happy with the setup (enough to share it and not be embarrassed); things I’m looking forward to fixing:

Hopefully some of this is of use to y’all! Thanks for reading, and feel free to weigh in with questions or improvements!


Wow. Thanks @deuill for sharing!

Thanks for the work you’ve put in! My previous setup was a Minikube-based one, and compared to that (and alternatives, such as an Ansible/Debian-based setup) CoreOS is a breath of fresh air and very simple to wrap my mind around and operationalize. The fact that it’s all essentially based on systemd and Podman, two technologies that will likely remain stable for a long time, is the proverbial cherry on top. FCCT/Butane have also been awesome.

Apart from the notes above, I’m also excited to see some movement around live-updates (if I’m reading live updates design · Issue #639 · coreos/rpm-ostree · GitHub correctly), which will make the auto-update system even better than it already is. Having said that, I should add some Zincati systemd drop-ins for email notifications on update.

Agreed, very cool! I have a somewhat similar subset of that Makefile myself.

It might be nice to try factoring out a base repository setup perhaps even in the coreos/ GH organization?

Or, maybe our documentation should have links to “featured setups”? This seems like a good one to have there.

Thanks so much for sharing!

1 Like

I’ve added that to the list at List of unofficial tutorials · Issue #305 · coreos/fedora-coreos-docs · GitHub until we find a better place.

Awesome, thanks so much! I’ll work on improving documentation here, especially as it pertains to design choices/rationale, which may help others make (more) informed decisions without necessarily using the exact same setup.

1 Like

So cool! This might be a nice Fedora Magazine article, too!

1 Like