rustguac wiki

This is the community-maintained wiki for rustguac. It complements the in-repo docs/ (which is reference material) with the why and how we actually run it notes that don't belong in a manual.

If you're new here, start with Why rustguac and Architecture. If you're trying to get it deployed, jump to one of the deployment guides below.

Background

Why rustguac - what it is, what it isn't, who it's for
Architecture - how the pieces fit together
Roadmap - what's shipped, what's planned, what's deferred

Getting it running

Deployment: Debian - the bare-metal path, and what we actually run in production
Deployment: Docker - container deployment, compose, persistence
Deployment: Red Hat / Fedora - RPM build, EL9 / Rocky / Alma / Fedora
Building from source - dev environment, guacamole-server patches, fast iteration

Security

Attack surface - what's exposed, what's behind auth, what we worry about
Knocknoc integration - removing the front page from the public internet

Help

Troubleshooting - common failures and how to read the logs
FAQ

Reference docs

The in-repo docs/ tree is the reference material. The wiki and the docs aren't supposed to repeat each other; if a page here just restates the manual, please rip it out.

Contributing

This wiki is open. If something's wrong, out of date, or missing, edit it. If you've deployed rustguac somewhere unusual and have notes, add a page. The bar for landing wiki content is much lower than for landing repo PRs.

Bug reports and feature requests still belong in issues.

Home