# 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) - Get started with Gordon
- [Deploy a Next.js App](./tutorials/nextjs-deploy.md) - Full-stack JavaScript deployment
- [Add PostgreSQL to Your App](./tutorials/postgres-service.md) - Database attachments
- [Deploy Multi-Service Applications](./tutorials/multi-service-app.md) - Microservices setup

## Guides

In-depth guides for specific setups:

- [Podman Rootless Setup](./guides/podman-rootless.md) - Enhanced security with rootless containers
- [Cloudflare DNS & Proxy Setup](./guides/cloudflare-setup.md) - HTTPS termination with Cloudflare
- [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
- [Development Configuration](./examples/development.md) - Local development 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)