Errors

Could not connect to the database

Install wizard database test failed — check host, port, database name, username, and password.

Could not connect to the database

The install wizard database step could not run a simple connection test. Full text asks you to check host, port, database name, username, and password.

Why this happens

This is not a member login error. POST /api/install/env (or the wizard’s DB test) failed to SELECT 1 against Postgres — wrong credentials, firewall, wrong DB name, or Postgres down. More specific installer messages may appear for auth failure or timeout.

Diagnose and fix

1. On the VPS: confirm Postgres is running and listening on the expected host/port.

2. Verify database name, user, and password; test with psql from the app host.

3. Allow the app server through any firewall/security group to Postgres.

4. Re-run the install wizard DB step; fix DATABASE_URL in .env if editing by hand.

Related