# Gordon Wiki

Community tutorials, guides, and examples for Gordon.

## Tutorials

Step-by-step guides for common tasks:

- [Deploy Your First App](./tutorials/first-deploy.md) - Deploy a simple web app in minutes
- [Add PostgreSQL to Your App](./tutorials/postgres-service.md) - Database attachments

> **New to Gordon?** Start with the [Getting Started guide](/docs/getting-started.md) in the official docs.

## Guides

In-depth guides for specific setups:

- [Secure VPS Setup](./guides/secure-vps-setup.md) - Tailscale SSH, firewalld, and CrowdSec
- [Running Gordon in a Container](./guides/running-in-container.md) - Deploy Gordon itself in Docker or Podman
- [Podman Rootless Setup](./guides/podman-rootless.md) - Enhanced security with rootless containers
- [Remote CLI Management](./guides/remote-cli.md) - Manage Gordon instances remotely
- [Using Pass for Secrets](./guides/secrets-pass.md) - Unix password manager integration
- [Using SOPS for Secrets](./guides/secrets-sops.md) - Encrypted secrets with SOPS

## Agents

Guides for AI coding assistants:

- [Deployment Workflow](./agents/deploy.md) - Structured deployment guide for AI agents

## Examples

Configuration examples explained:

- [Minimal Configuration](./examples/minimal.md) - Simplest working setup
- [Production Configuration](./examples/production.md) - Full production setup

## Quick Links

- [Official Documentation](/docs/index.md)
- [Configuration Reference](/docs/config/index.md)
- [CLI Reference](/docs/cli/index.md)
- [GitHub Repository](https://github.com/bnema/gordon)

## 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](https://github.com/bnema/gordon)