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

All explanations

  • No error file at all — You will understand why a missing `LAST_FATAL_ERROR.md` file does not by itself mean the device is healthy.
  • Why credentials survive a reflash — You will understand how GoSD keeps a device's settings safe across a reflash, and why the identity key is different.
  • Why format authorization works this way — You will understand why `ATFS_FORMAT_DRIVES_IF_NOT_ATFS` takes a date, and why the two drives it covers carry different risks.