Skip to content
autonym.dev
ContentsHide contents

Self-hosting

In development. This page describes v0.1 draft behaviour. Commands and outputs may change before the first release.

The reference implementation is a single container image with Postgres behind it. It passes the Core, Write, Portable and Delegated conformance profiles, and it is the same code that runs the hosted service.

What you need

A domain, a TLS certificate, Postgres 16 or later, and somewhere to run a container.

What you get

The authorisation server, the MCP and REST surfaces, the consent screen, the person's app, the log, export and import, and the purge outbox.

Discovery

Serve /.well-known/autonym at the root of your domain. It lists the MCP and REST endpoints, the authorisation server metadata, the supported conformance profiles and the specification version.

Handles

A self-hosted record has a handle on your own domain: autonym:alex@example.org. Handles can be moved to another host without loss; see Export and move.