All documentation

Operator guide

Running Nosdesk in production.

For teams self-hosting Nosdesk. Environment configuration, advisory-locking semantics for background workers, how to point at a custom registry, and how to bake a custom root public key when you're running a fork.

Planned topics

Each of these will become a written page. If one of them is blocking you, let us know and we'll prioritise it.

  • Environment variables

    Coming soon

    Every NOSDESK_* / DATABASE_URL / STORAGE_TYPE switch and what it does.

  • Advisory locking

    Coming soon

    How Postgres advisory locks coordinate background workers across replicas.

  • Registry configuration

    Coming soon

    NOSDESK_REGISTRY_URL, baked-in root pubkey, fork-specific registry hosting.

  • Backup & restore

    Coming soon

    Operational notes on snapshot export, archive layout, restore prerequisites.

  • Reverse proxy + TLS

    Coming soon

    Recommended Caddy / nginx configurations for production deployments.

Need this sooner?

We're writing docs in the order people ask for them. Tell us what you're working on and we'll move it up the list.

Get in touch All sections