1# Minimal Configuration
2
3The simplest working Gordon configuration.
4
5## When to Use
6
7- Getting started with Gordon
8- Local development
9- Testing Gordon features
10
11## Configuration
12
13```toml
14# ~/.config/gordon/gordon.toml
15
16[server]
17port = 8080
18registry_port = 5000
19gordon_domain = "gordon.local"
20
21# Authentication disabled for simplicity
22[auth]
23enabled = false
24
25# Simple route
26[routes]
27"app.local" = "myapp:latest"
28```
29
30## Setup
31
32### 1. Add to /etc/hosts
33
34```bash
35echo "127.0.0.1 app.local gordon.local" | sudo tee -a /etc/hosts
36```
37
38### 2. Start Gordon
39
40```bash
41gordon serve
42```
43
44### 3. Build and Deploy
45
46```bash
47docker build -t myapp .
48docker tag myapp gordon.local:5000/myapp:latest
49docker push gordon.local:5000/myapp:latest
50```
51
52### 4. Access
53
54Open http://app.local:8080
55
56## What's Included
57
58| Feature | Enabled |
59|---------|---------|
60| Registry | Yes |
61| HTTP Proxy | Yes |
62| Authentication | No |
63| Logging | Console only |
64| Network Isolation | No |
65| Attachments | No |
66
67## What's Not Included
68
69- HTTPS (requires Cloudflare or similar)
70- Registry authentication
71- File-based logging
72- Network isolation
73- Service attachments
74
75## Next Steps
76
77To add more features:
78
79```toml
80# Enable logging
81[logging.file]
82enabled = true
83path = "~/.gordon/logs/gordon.log"
84
85# Enable network isolation
86[network_isolation]
87enabled = true
88
89# Add attachments
90[attachments]
91"app.local" = ["postgres:latest"]
92```
93
94## Related
95
96- [Production Configuration](./production.md)