Troubleshooting
Below are the most common deployment issues:
- Unexpected folder structure. See the squid structure for details.
- Docker build failures. Build a Docker images locally (see below) to troubleshoot.
- Database migration failures. Troubleshoot by executing the DB migration locally with a locally built image (see below).
- Outdated Squid SDK packages. Update to the latest SDK lib versions with
npm run update
.
Local Docker build
To make a dry run locally, create a local Dockerfile
as described on the self-hosting page.
Then build an image locally with
docker build . -t my-squid
and fix the squid if necessary.
Local migration run
To test the migration scripts:
- Start a fresh database:
docker compose down
docker compose up db -d
- Run
npx squid-typeorm-migration apply
with the local squid image:
docker run --rm -e DB_HOST=host.docker.internal --env-file=.env my-squid npx squid-typeorm-migration apply