diff --git a/docs/reset-db-password.md b/docs/reset-db-password.md deleted file mode 100644 index 59d4631..0000000 --- a/docs/reset-db-password.md +++ /dev/null @@ -1,57 +0,0 @@ -# Resetting the Kutt PostgreSQL password - -If you lost the stack env vars (e.g. after deleting the Portainer stack) and need to use the existing database with a new password, you have two options. - -**Default DB user/db name from compose:** `kutt` / `kutt` (or whatever you set in `DB_USER` / `DB_NAME`). -**Data path on host:** `/mnt/config/docker/kutt/postgres` (from `docker-compose.portainer.yml`). - ---- - -## Option A: Fresh start (delete all Kutt data) - -Use this if you **don’t need** existing links/users. - -1. On the host, remove the Postgres data directory: - ```bash - sudo rm -rf /mnt/config/docker/kutt/postgres - ``` -2. In Portainer, (re-)create the stack and set env vars, including a new `DB_PASSWORD`. -3. Deploy. Postgres will initialise a new database with the new password. - ---- - -## Option B: Keep data, force-set a new password - -Use this if you **want to keep** existing Kutt data but don’t know the current password. -**Stop the stack first** (so nothing is using the Postgres data volume). - -1. On the host, temporarily allow local connections without a password: - ```bash - cd /mnt/config/docker/kutt/postgres - cp pg_hba.conf pg_hba.conf.bak - echo 'local all all trust' > pg_hba.conf - echo 'host all all 127.0.0.1/32 trust' >> pg_hba.conf - echo 'host all all ::1/128 trust' >> pg_hba.conf - ``` - -2. Start a temporary Postgres container (it will use the modified `pg_hba.conf`): - ```bash - docker run -d --name pg-reset \ - -v /mnt/config/docker/kutt/postgres:/var/lib/postgresql/data \ - postgres:16-alpine - sleep 5 - ``` - -3. Set the new password (replace `kutt` if you use a different `DB_USER`, and set `YOUR_NEW_PASSWORD`): - ```bash - docker exec pg-reset psql -U postgres -c "ALTER USER kutt PASSWORD 'YOUR_NEW_PASSWORD';" - ``` - -4. Stop the temporary container and restore `pg_hba.conf`: - ```bash - docker stop pg-reset && docker rm pg-reset - cd /mnt/config/docker/kutt/postgres - mv pg_hba.conf.bak pg_hba.conf - ``` - -5. In Portainer, create/redeploy the stack and set `DB_PASSWORD` (and other env vars) to the same `YOUR_NEW_PASSWORD`.