====== Docker File Mounting Issues ======

Container fails to start with file mounting errors.

===== Symptom =====

Container fails to start with "not a directory" errors. Files being mounted as directories instead of files. Configuration files not being read correctly.

===== Cause =====

Source files are directories instead of regular files when mounting in Docker.

===== Fix =====

**Steps:**
  1. Check file type: `ls -la ~/folkzone-new/irc/`
  2. Remove incorrectly created directories: `sudo rm -rf ~/folkzone-new/irc/config.yml` (if it's a directory)
  3. Copy correct file: `cp correct/path/config.yml ~/folkzone-new/irc/config.yml`
  4. Verify file is regular file: `file ~/folkzone-new/irc/config.yml`
  5. Restart container: `docker compose up -d service-name`

===== Prevention =====

Always verify file types before mounting. Use `file` command to check if a path is a file or directory.

===== See Also =====

  * [[folkzone:troubleshooting:start|Troubleshooting Index]]
  * [[folkzone:infrastructure:docker|Docker Infrastructure]]

Last updated: 2026-06-19
  * [[folkzone:start|Return to folkzone]]