Set up an SD-card device

You will run atfs on an SD-card device and upload a file to it.

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

1. Get a card image

Download an atfs .img for your board from atfs.dev/setup/. Use the web-based setup tool there — it injects your owner DID and a fresh identity key into the image, so you skip manual editing later. See Use the web-based setup tool if you want the details first.

2. Flash the card

Write the image to an SD card with balena Etcher. See Flash a card with balena Etcher for the steps.

3. Boot the board

Insert the card and power on the board. Give it a minute to start.

4. Confirm it is healthy

Visit the device’s address on port 2837 in a browser, or check its console output. See Is the device working? for what a normal startup looks like.

5. Create the server record

If you used the setup tool, this step is already done. If you flashed a plain image, create the dev.atfs.server record yourself — see Required settings.

You are done. Upload a file with the atfs CLI to confirm.