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

Troubleshooting

You will discover why your atfs device will not start, or is showing an error, and how to resolve it.


  • Is the device working? — check whether the device is actually unhealthy, with or without a serial console.
  • No error file at all — what a missing LAST_FATAL_ERROR.md file does and does not tell you.
  • Read LAST_FATAL_ERROR.md — find and interpret the error file, if one exists.