1
0
mirror of https://github.com/immich-app/immich.git synced 2025-04-20 12:51:54 +02:00
immich/docs/docs/guides/database-gui.md
aviv926 19d4c5e9f7
docs: Update documentation (#6430)
* 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>
2024-01-25 17:17:38 +00:00

1.6 KiB

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.

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 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 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. :::