Use the setup tool

You will fill in a card's settings in your browser, before ever flashing it.

This page only applies when you deploy to an SD-card device.

The setup tool at /setup/ writes settings straight into an atfs .img file, before or after you flash it. Every setting’s file on the card is padded to a fixed size, and the image publishes each one’s byte range. The setup tool overwrites exactly those bytes with real values. It needs no FAT32 knowledge to do this, so it works entirely in your browser.

1. Open /setup/.
2. Sign in with your atproto account.
3. The tool generates a libp2p identity key in your browser. This key is sent nowhere else.
4. Save the generated identity key somewhere safe.
5. The tool writes your instance’s dev.atfs.server record.
6. The tool splices your owner DID and identity key into a downloaded .img file, or one already on disk.

Once the image carries your settings, flash it. See Flash a card with balena Etcher.

Prefer to edit files by hand instead? See DIY editing for the manual equivalent.