Files
immich/docs/docs/developer/troubleshooting.md
Jason Rasmussen f6180fccdc chore(server): compose updates (#4878)
* chore: compose updates

* chore: docs for troubleshooting

* chore: add reference in docker compose to docs
2023-11-07 11:34:03 -05:00

1.1 KiB

Troubleshooting

:::tip A great option to get assistance with troubleshooting is to join our Discord server, where we have a dedicated channel for #contributing. :::

Known Issues

Running on Windows

Running Immich on Windows can be frustrating and there are lots of ways it can go wrong. Where possible we recommend using Docker on Linux. However, several people have had success running Immich on Windows using Docker via WSL2.

NTFS Mounted Volumes

The docker-compose.dev.yml and docker-compose.prod.yml use volume mounts for the postgres database. On start-up, postgres will try to chown the data directory, but fail. See this post for more information about this issue and possible solutions.

Cannot read properties of null (reading 'split')

This error occurs when trying to access the app via port 3000 instead of 2283. During development immich-proxy runs on port 2283, while immich-web runs on 3000.