Gordon

Self-hosted web app deployments. Push to your registry, Gordon does the rest.

Website: https://gordon.bnema.dev
Documentation: Docs | Wiki
Discuss: GitHub Discussions

What is Gordon?

Gordon is a private container registry + HTTP reverse proxy for your VPS. Push a container image exposing a web port, it deploys automatically with zero downtime.

docker build -t myapp .
docker push registry.your-server.com/myapp:latest
# → Live at https://app.your-server.com

Build on your machine, push to deploy. Works from your laptop or CI.

Features:

Private Docker registry on your VPS
Domain-to-container routing via HTTP reverse proxy
Automatic deployment on image push
Zero downtime updates
Persistent volumes from Dockerfile VOLUME directives
Environment variable management with secrets support
Network isolation per application
Single binary, ~15MB RAM

Documentation

Full documentation is available at gordon.bnema.dev

Documentation - Installation, configuration, CLI reference
Wiki - Tutorials, guides, and examples

Quick Start

# Download and install
wget https://github.com/bnema/gordon/releases/latest/download/gordon_linux_amd64.tar.gz
tar -xzf gordon_linux_amd64.tar.gz
chmod +x gordon
sudo mv gordon /usr/local/bin/

# Start Gordon (generates config on first run)
gordon start

Config is created at ~/.config/gordon/gordon.toml. See the Getting Started guide for complete setup instructions.

Community

License

GPL-3.0 - Use freely, contribute back.

source

1# Gordon
2
3[![License: GPL-3.0](https://img.shields.io/badge/License-GPL%203.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
4[![Go Report Card](https://goreportcard.com/badge/github.com/bnema/gordon)](https://goreportcard.com/report/github.com/bnema/gordon)
5
6Self-hosted web app deployments. Push to your registry, Gordon does the rest.
7
8- Website: https://gordon.bnema.dev
9- Documentation: [Docs](https://gordon.bnema.dev/docs) | [Wiki](https://gordon.bnema.dev/wiki)
10- Discuss: [GitHub Discussions](https://github.com/bnema/gordon/discussions)
11
12---
13
14## What is Gordon?
15
16Gordon is a private container registry + HTTP reverse proxy for your VPS. Push a container image exposing a web port, it deploys automatically with zero downtime.
17
18```bash
19docker build -t myapp .
20docker push registry.your-server.com/myapp:latest
21# → Live at https://app.your-server.com
22```
23
24Build on your machine, push to deploy. Works from your laptop or CI.
25
26**Features:**
27- Private Docker registry on your VPS
28- Domain-to-container routing via HTTP reverse proxy
29- Automatic deployment on image push
30- Zero downtime updates
31- Persistent volumes from Dockerfile VOLUME directives
32- Environment variable management with secrets support
33- Network isolation per application
34- Single binary, ~15MB RAM
35
36## Documentation
37
38Full documentation is available at **[gordon.bnema.dev](https://gordon.bnema.dev)**
39
40- [Documentation](https://gordon.bnema.dev/docs) - Installation, configuration, CLI reference
41- [Wiki](https://gordon.bnema.dev/wiki) - Tutorials, guides, and examples
42
43## Quick Start
44
45```bash
46# Download and install
47wget https://github.com/bnema/gordon/releases/latest/download/gordon_linux_amd64.tar.gz
48tar -xzf gordon_linux_amd64.tar.gz
49chmod +x gordon
50sudo mv gordon /usr/local/bin/
51
52# Start Gordon (generates config on first run)
53gordon start
54```
55
56Config is created at `~/.config/gordon/gordon.toml`. See the [Getting Started guide](https://gordon.bnema.dev/docs/getting-started) for complete setup instructions.
57
58## Community
59
60- [Report bugs](https://github.com/bnema/gordon/issues)
61- [Discussions](https://github.com/bnema/gordon/discussions)
62- [Submit PRs](https://github.com/bnema/gordon/pulls)
63
64## License
65
66GPL-3.0 - Use freely, contribute back.

README.md RawHistoryFolder