Horus

! ⚠️ WORK IN PROGRESS

The name is from Horus the Child, or Harpocrates

Horus is an opinionated framework for self-hosting on a free or low-cost VPS in order to reclaim control over your data. This repository is intended to be forked in order to be customized to your specific needs.

Features

Infrastructure

Oracle Cloud was chosen due to their very generous free tier.

Provider	Service	Usage	Pricing
Terraform Cloud	Workspace	1	Free
Oracle Cloud	Virtual Cloud Network	1	Free
Oracle Cloud	VM.Standard.A1.Flex (ARM)	4 cores, 24GB mem	Free (yes, you read it right!)
Oracle Cloud	Block Storage	200GB	Free

Applications

• Hugo blog
• Mail server (receive only, outbound SMTP is blocked by default, you must upgrade to a paid account to open a service limits request to request an exemption)
• Web analytics
• Wireguard VPN server
• TBD

Get started

Prerequisites

• Fork this repository because you will need to customize it for your needs.
• A credit/debit card to register for the accounts.
• Basic knowledge on Terraform, Ansible and Kubernetes (optional, but will help a lot)

Configuration files:

Terraform Cloud

• Create a Terraform Cloud account at https://app.terraform.io
• Run terraform login and follow the instruction

Oracle Cloud

• Create an Oracle Cloud account at https://cloud.oracle.com
• Generate an API signing key:
  • Profile menu (User menu icon) -> User Settings -> API Keys -> Add API Key
  • Select Generate API Key Pair, download the private key to ~/.oci/private.pem and click Add
  • Copy the Configuration File Preview to ~/.oci/config and change key_file to ~/.oci/private.pem

If you see a warning like this, try to avoid those regions:

⚠️ Because of high demand for Arm Ampere A1 Compute capacity in the Foo and Bar regions, A1 instance availability in these regions is limited. If you plan to create A1 instances, we recommend choosing another region as your home region

Remember to backup the following credential files (you can put them in a password manager):

• ~/.terraform.d/credentials.tfrc.json
• ~/.oci/config
• ~/.oci/private.pem

Install the following packages:

• Nix

That's it! Run the following command to open the Nix shell:

nix-shell

Provision

Build the infrastructure:

make

Usage

TBD

Acknowledgments and References

• Oracle Terraform Modules
• Official k3s systemd service file