Skip to content
atfs Docs Download
Getting started
  • Set up an SD-card device
  • Set up a Docker container
Configuration
  • Required settings
  • Expose to the internet
SD-card image
  • Flash a card with balena Etcher
  • Use the setup tool
  • DIY editing
  • Reflash to upgrade
  • Move to new hardware
  • Why credentials survive a reflash
Troubleshooting
  • Is the device working?
  • No error file at all
  • Read LAST_FATAL_ERROR.md
  • Why format authorization works this way
Integration
  • Upload a file over the size limit
Reference
  • Settings reference
  • System (GoSD) error codes
  • ATFS-BAD-IDENTITY-KEY
  • ATFS-BAD-MAX-REQUEST-BODY
  • ATFS-BAD-OWNER
  • ATFS-DATA-READONLY
  • ATFS-EMMC-FOREIGN
  • ATFS-EMMC-UNHEALTHY
  • ATFS-NO-OWNER
  • IPFS chunking defaults
How-to guide

Configuration

You will discover what atfs needs to run, and how to make it reachable from the internet.


Local configuration is a small set of environment variables. Everything else lives in an atproto record, covered elsewhere in these docs.

  • Required settings โ€” the environment variables atfs needs, and why.
  • Expose to the internet โ€” getting a public HTTPS hostname pointed at your instance.