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
Auto-routing from image labels
Remote CLI management
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

# Install Gordon
curl -fsSL https://gordon.bnema.dev/install.sh | sh
# Or: curl -fsSL https://raw.githubusercontent.com/bnema/gordon/main/install.sh | sh

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

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- Auto-routing from image labels
31- Remote CLI management
32- Zero downtime updates
33- Persistent volumes from Dockerfile VOLUME directives
34- Environment variable management with secrets support
35- Network isolation per application
36- Single binary, ~15MB RAM
37
38## Documentation
39
40Full documentation is available at **[gordon.bnema.dev](https://gordon.bnema.dev)**
41
42- [Documentation](https://gordon.bnema.dev/docs) - Installation, configuration, CLI reference
43- [Wiki](https://gordon.bnema.dev/wiki) - Tutorials, guides, and examples
44
45## Quick Start
46
47```bash
48# Install Gordon
49curl -fsSL https://gordon.bnema.dev/install.sh | sh
50# Or: curl -fsSL https://raw.githubusercontent.com/bnema/gordon/main/install.sh | sh
51
52# Start Gordon (generates config on first run)
53gordon serve
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