Skip to content

Overview

The goal of this guide is to walk you through the installation of a homeserver. We're going to install the k3s Kubernetes distribution which will be running Emporium.

Below is a detailed list of all the components we're going to install. Note that this is soely an example. You run Emporium on any Kubernetes cluster you want, the only requirement is that you have some sort of an automated TLS / DNS setup. Usually this is done using Cert Manager and External DNS.

Components

In the following guide we're going to install a production-ready Kubernetes cluster with these components.

Prerequisites

You will need a server running the linux distribution of your choice. We recommend Fedora Server. You can follow the offical documentation to get up and running.

Hardware

You're free to use what ever hardware you have access to. We're currenlty using Intel NUX 13 Pro as our test hardware. This is a reasonable solution for home deployments, thanks to it's small size and reasonable power usage.