Gordon Wiki

Community tutorials, guides, and examples for Gordon.

Tutorials

Step-by-step guides for common tasks:

• Deploy Your First App - Deploy a simple web app in minutes
• Add PostgreSQL to Your App - Database attachments

New to Gordon? Start with the Getting Started guide in the official docs.

Guides

In-depth guides for specific setups:

• Secure VPS Setup - Tailscale SSH, firewalld, and CrowdSec
• Running Gordon in a Container - Deploy Gordon itself in Docker or Podman
• Podman Rootless Setup - Enhanced security with rootless containers
• Remote CLI Management - Manage Gordon instances remotely
• Using Pass for Secrets - Unix password manager integration
• Using SOPS for Secrets - Encrypted secrets with SOPS
• Health Monitoring with systemd - Desktop alerts when routes go down

Agents

Guides for AI coding assistants:

• Deployment Workflow - Structured deployment guide for AI agents

Examples

Configuration examples explained:

• Minimal Configuration - Simplest working setup
• Production Configuration - Full production setup

Quick Links

• Official Documentation
• Configuration Reference
• CLI Reference
• GitHub Repository

Contributing

Found an error or want to add a tutorial? Contributions are welcome!

• Edit documentation in the docs/ and wiki/ folders
• Submit a pull request to github.com/bnema/gordon