More setup info

Author: sjmiller609

.env.example

@@ -0,0 +1 @@
+JWT_SECRET='your-secret-key-here'

.gitignore

@@ -10,3 +10,6 @@ data/**
 kernel
 kernel/**
 bin/**
+.env
+tmp
+tmp/**

README.md

@@ -8,9 +8,25 @@ Run containerized workloads in VMs, powered by [Cloud Hypervisor](https://github
 
 ### Prerequisites
 
-- Go 1.25.4+
-- Cloud Hypervisor
-- containerd
+**Cloud Hypervisor** - [Installation guide](https://www.cloudhypervisor.org/docs/prologue/quick-start/#use-pre-built-binaries)
+```bash
+cloud-hypervisor --version  # Verify
+ch-remote --version
+```
+
+**containerd** - [Installation guide](https://github.com/containerd/containerd/blob/main/docs/getting-started.md)
+```bash
+containerd --version  # Verify
+```
+
+**Go 1.25.4+** and **KVM**
+
+### Configuration
+
+```bash
+cp .env.example .env
+# Edit .env and set JWT_SECRET
+```
 
 ### Build
 

cmd/api/config/config.go

@@ -2,6 +2,8 @@ package config
 
 import (
 	"os"
+
+	"github.com/joho/godotenv"
 )
 
 type Config struct {
@@ -15,8 +17,13 @@ type Config struct {
 	DNSServer        string
 }
 
+// Load loads configuration from environment variables
+// Automatically loads .env file if present
 func Load() *Config {
-	return &Config{
+	// Try to load .env file (fail silently if not present)
+	_ = godotenv.Load()
+
+	cfg := &Config{
 		Port:             getEnv("PORT", "8080"),
 		DataDir:          getEnv("DATA_DIR", "/var/lib/hypeman"),
 		BridgeName:       getEnv("BRIDGE_NAME", "vmbr0"),
@@ -26,6 +33,8 @@ func Load() *Config {
 		JwtSecret:        getEnv("JWT_SECRET", ""),
 		DNSServer:        getEnv("DNS_SERVER", "1.1.1.1"),
 	}
+
+	return cfg
 }
 
 func getEnv(key, defaultValue string) string {

go.mod

@@ -8,6 +8,7 @@ require (
 	github.com/go-chi/chi/v5 v5.2.3
 	github.com/golang-jwt/jwt/v5 v5.3.0
 	github.com/google/wire v0.7.0
+	github.com/joho/godotenv v1.5.1
 	github.com/oapi-codegen/runtime v1.1.2
 	github.com/stretchr/testify v1.11.1
 	golang.org/x/sync v0.17.0

go.sum

@@ -23,6 +23,8 @@ github.com/google/uuid v1.5.0 h1:1p67kYwdtXjb0gL0BPiP1Av9wiZPo5A8z2cWkTZ+eyU=
 github.com/google/uuid v1.5.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/google/wire v0.7.0 h1:JxUKI6+CVBgCO2WToKy/nQk0sS+amI9z9EjVmdaocj4=
 github.com/google/wire v0.7.0/go.mod h1:n6YbUQD9cPKTnHXEBN2DXlOp/mVADhVErcMFb0v3J18=
+github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
+github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
 github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY=
 github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
 github.com/juju/gnuflag v0.0.0-20171113085948-2ce1bb71843d/go.mod h1:2PavIy+JPciBPrBUjwbNvtwB6RQlve+hkpll6QSNmOE=