v3.3.2 9697f9d

index.md RawHistoryFolder

Gordon Wiki

Community tutorials, guides, and examples for Gordon.

Tutorials

Step-by-step guides for common tasks:

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

Guides

In-depth guides for specific setups:

Agents

Guides for AI coding assistants:

Examples

Configuration examples explained:

Contributing

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

source
1# Gordon Wiki
2
3Community tutorials, guides, and examples for Gordon.
4
5## Tutorials
6
7Step-by-step guides for common tasks:
8
9- [Deploy Your First App](./tutorials/first-deploy.md) - Deploy a simple web app in minutes
10- [Add PostgreSQL to Your App](./tutorials/postgres-service.md) - Database attachments
11
12> **New to Gordon?** Start with the [Getting Started guide](/docs/getting-started.md) in the official docs.
13
14## Guides
15
16In-depth guides for specific setups:
17
18- [Secure VPS Setup](./guides/secure-vps-setup.md) - Tailscale SSH, firewalld, and CrowdSec
19- [Running Gordon in a Container](./guides/running-in-container.md) - Deploy Gordon itself in Docker or Podman
20- [Podman Rootless Setup](./guides/podman-rootless.md) - Enhanced security with rootless containers
21- [Remote CLI Management](./guides/remote-cli.md) - Manage Gordon instances remotely
22- [Using Pass for Secrets](./guides/secrets-pass.md) - Unix password manager integration
23- [Using SOPS for Secrets](./guides/secrets-sops.md) - Encrypted secrets with SOPS
24- [Health Monitoring with systemd](./guides/health-monitoring.md) - Desktop alerts when routes go down
25
26## Agents
27
28Guides for AI coding assistants:
29
30- [Deployment Workflow](./agents/deploy.md) - Structured deployment guide for AI agents
31
32## Examples
33
34Configuration examples explained:
35
36- [Minimal Configuration](./examples/minimal.md) - Simplest working setup
37- [Production Configuration](./examples/production.md) - Full production setup
38
39## Quick Links
40
41- [Official Documentation](/docs/index.md)
42- [Configuration Reference](/docs/config/index.md)
43- [CLI Reference](/docs/cli/index.md)
44- [GitHub Repository](https://github.com/bnema/gordon)
45
46## Contributing
47
48Found an error or want to add a tutorial? Contributions are welcome!
49
50- Edit documentation in the `docs/` and `wiki/` folders
51- Submit a pull request to [github.com/bnema/gordon](https://github.com/bnema/gordon)

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 7

Tags 106

↑↓ moveenter openesc close