mirror of
https://github.com/immich-app/immich.git
synced 2025-04-20 12:51:54 +02:00
19d4c5e9f7
* Documentation corrections * fix import * add firewall note * npm run format:fix * fixs * npm run format:fix * space * fix note * admin-jobs.png image update + fixes * Storage Template.md update * Add new Troubleshooting about symbolic link in library * Updating the libraries.md * Updating the libraries.md * Corrections * add `/` * ... * Add Python script to remove-offline-files.md * npm run format:fix * Add info about HDR in FAQ * My wrong merge * add info about symlink * [Community] + PowerShell * add 360 photo support to Features in README * add info about remote ML and info about orphaned files from the external library to the scripts page * Typo * add note about storage locations * add info about Purge for portainer and link to info about asset types and storage locations * npm run format:fix * Add FAQ about "faces" that aren't faces * Update docs/docs/administration/backup-and-restore.md * Update docs/docs/administration/backup-and-restore.md --------- Co-authored-by: Jason Rasmussen <jrasm91@gmail.com>
50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
# Database GUI
|
|
|
|
A short guide on connecting [pgAdmin](https://www.pgadmin.org/) 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.
|
|
|
|
**Optional:** To connect to the database **outside** of your Docker's network:
|
|
|
|
- Expose port 5432 in your `docker-compose.yml` file.
|
|
- Edit the PostgreSQL [`pg_hba.conf`](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html) file.
|
|
- Make sure your firewall does not block access to port 5432.
|
|
Note that exposing the database port increases the risk of getting attacked by hackers.
|
|
Make sure to remove the binding port after finishing the database's tasks.
|
|
|
|
:::
|
|
|
|
## 1. Install pgAdmin
|
|
|
|
Download and install [pgAdmin](https://www.pgadmin.org/download/) 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](https://immich.app/docs/guides/database-queries/) for common database queries.
|
|
:::
|