Skip to content

Private federation

A private federation shares bans only between servers you invite. Most networks start here and join the public federation later, if at all.

  1. On any server, run /psync federation create <name>. The name is shown to members, pick something your staff will recognise.
  2. The command prints an invite code. It works for 24 hours and for any number of servers.
  3. On every other server, run /psync federation join <code>.
  4. Set federation: <name> in each server’s config so a fresh install joins the right one.
Role Can
Owner Invite and remove members, rotate keys, delete the federation
Member Publish and receive records
Observer Receive records only, useful for a test server

Change a role with /psync federation role <server> <role>.

/psync federation leave stops sync at once. Records already applied stay on your server; remove them with /psync purge <federation> if you want a clean list.