immich/docs/docs/guides/database-gui.md

Database GUI

A short guide on connecting pgAdmin to Immich.

:::note

• In order to connect to the database the immich_postgres container must be running.
• The passwords and usernames used below match the ones specified in the example .env file. If changed, please use actual values instead.

:::

1. Install pgAdmin

Download and install pgAdmin following the official documentation.

2. Add a Server

Open pgAdmin and click "Add New Server".

<img src={require('./img/add-new-server-option.png').default} width="50%" title="new server option" />

3. Enter Connection Details

Name	Value
Host name/address	localhost
Port	5432
Maintenance database	immich
Username	postgres
Password	postgres

<img src={require('./img/Connection-Pgadmin.png').default} width="75%" title="Connection" />

4. Save Connection

Click on "Save" to connect to the Immich database.

:::tip View Database Queries for common database queries. :::