Get started

Get an access key

An access key lets your server download Moorhold. You create it yourself, in your Moorhold account at account.moorhold.dev.

Create your account

Already have an account? Go to your account.

How it works

  1. Create your account

    Give your email address and confirm it with the code we send, then sign in with a passkey on your phone or computer. There is no password.

  2. Name your organisation

    It's approved automatically, or by a person at Moorhold if it's held for review. If it's held, we email you when it's approved.

  3. Create a key

    Name it after the server it is for. The key is shown once, on that page: copy it straight into your cloud config.

  4. Use it

    Your server uses the key while it installs, to download Moorhold's images, and keeps a copy that only root can read, for upgrades and for running the installer again. Nothing else uses it. The install guides show where it goes, and Upgrading says how to update a server.

About the key

  • It can only download Moorhold's software and check your server's plan. It can't read or change anything in your stack.
  • We never send keys by email, and we store only a fingerprint of each key, so we cannot show it to you again. If you lose it, make a new one.
  • You can revoke a key at any time, at account.moorhold.dev. Keys expire 12 months after you make them.
  • To give your server a new key, run sudo moorhold access-key set on it and paste the key when it asks. The server checks the new key with the registry before it replaces the one it keeps.
  • Moorhold keeps running if a key is revoked or expires. Releases that include the plan check also use the key to check the server's plan, sending the key and the number of the release it runs, never your data. The privacy notice lists when a server contacts us. That includes a plan check when an admin turns automatic updates off or pauses them.
  • Upgrades and reruns of the installer need a working key. If yours is revoked or has expired, make a new one and run sudo moorhold access-key set on the server.
  • Every other password and key in your stack is generated on your server and never leaves it.

Questions: hello@moorhold.dev.