# Troubleshooting (https://portunus.bybee.dev/en/docs/standalone/troubleshooting)



## Common failures [#common-failures]

* **Config-file permissions matter.**
  * systemd: the process runs as `User=portunus` with
    `ReadOnlyPaths=/etc/portunus`. The installer sets
    `chown root:portunus` + `chmod 0640`. Anything stricter
    (e.g. `chmod 0600 root:root`) will cause startup to fail.
  * Docker: the container runs as UID 65532. The host file must be
    readable by that UID — `chmod 0644` is the simplest fix.
* **Snap-packaged Docker on Ubuntu** confines bind-mount sources to
  `/home`, `/media`, `/mnt`, and a few other allowlisted paths.
  Bind-mounts from `/root`, `/tmp`, or `/etc` will surface as
  `No such file or directory` inside the container. Keep
  `portunus.toml` under `/home`, or install the non-snap
  `docker-ce`/`docker.io` packages.
