AdventureLog/documentation/docs/configuration/immich_integration.md

# Immich Integration

### What is Immich?

<!-- immich banner -->

![Immich Banner](https://repository-images.githubusercontent.com/455229168/ebba3238-9ef5-4891-ad58-a3b0223b12bd)

Immich is a self-hosted, open-source platform that allows users to backup and manage their photos and videos similar to Google Photos, but with the advantage of storing data on their own private server, ensuring greater privacy and control over their media.

- [Immich Website and Documentation](https://immich.app/)
- [GitHub Repository](https://github.com/immich-app/immich)

### How to integrate Immich with AdventureLog?

To integrate Immich with AdventureLog, you need to have an Immich server running and accessible from where AdventureLog is running.

1. Obtain the Immich API Key from the Immich server.
   - In the Immich web interface, click on your user profile picture, go to `Account Settings` > `API Keys`.
   - Click `New API Key` and name it something like `AdventureLog`.
   - Copy the generated API Key, you will need it in the next step.
2. Go to the AdventureLog web interface, click on your user profile picture, go to `Settings` and scroll down to the `Immich Integration` section.
   - Enter the URL of your Immich server, e.g. `https://immich.example.com/api`. Note that `localhost` or `127.0.0.1` will probably not work because Immich and AdventureLog are running on different docker networks. It is recommended to use the IP address of the server where Immich is running ex `http://my-server-ip:port` or a domain name.
   - Paste the API Key you obtained in the previous step.
   - Click `Enable Immich` to save the settings.
3. Now, when you are adding images to an adventure, you will see an option to search for images in Immich or upload from an album.

Enjoy the privacy and control of managing your travel media with Immich and AdventureLog! 🎉
docs: add Immich integration documentation and update configuration menu 2025-01-02 19:00:11 -05:00			`# Immich Integration`

			`### What is Immich?`

			`<!-- immich banner -->`

			`![Immich Banner](https://repository-images.githubusercontent.com/455229168/ebba3238-9ef5-4891-ad58-a3b0223b12bd)`

			`Immich is a self-hosted, open-source platform that allows users to backup and manage their photos and videos similar to Google Photos, but with the advantage of storing data on their own private server, ensuring greater privacy and control over their media.`

			`- [Immich Website and Documentation](https://immich.app/)`
			`- [GitHub Repository](https://github.com/immich-app/immich)`

			`### How to integrate Immich with AdventureLog?`

			`To integrate Immich with AdventureLog, you need to have an Immich server running and accessible from where AdventureLog is running.`

			`1. Obtain the Immich API Key from the Immich server.`
			- In the Immich web interface, click on your user profile picture, go to `Account Settings` > `API Keys`.
			- Click `New API Key` and name it something like `AdventureLog`.
			`- Copy the generated API Key, you will need it in the next step.`
			2. Go to the AdventureLog web interface, click on your user profile picture, go to `Settings` and scroll down to the `Immich Integration` section.
Korean i18n (#503) * Update email.md Removing the single quotes allow SMTP to work -- it did not work otherwise. Also, [Google recommends TLS over SSL](https://support.google.com/a/answer/2520500?sjid=7564827219172741277-NA) * Update immich_integration.md Added the /api to the example URL for the Immich server. * Add Korean language support to Navbar and layout * chore: Korean translation (#502) * correct ko translation at Navbar.svelte * correct ko.json correct ko.json::adventures auto commit auto commit auto commit auto commit auto commit adventures collection dashboard home immich immich map navbar auto commit notes profile recommendations settings share transportations auto commit worldtravel polishing auto commit auto commit auto commit auto commit auto commit auto commit auto commit auto commit auto commit auto commit auto commit auto commit --------- Co-authored-by: Patrick McGuire <60325264+mcguirepr89@users.noreply.github.com> Co-authored-by: motox986 <49492476+motox986@users.noreply.github.com> Co-authored-by: Seongjun Ji <metalg0su@gmail.com> 2025-02-17 10:32:18 -05:00			- Enter the URL of your Immich server, e.g. `https://immich.example.com/api`. Note that `localhost` or `127.0.0.1` will probably not work because Immich and AdventureLog are running on different docker networks. It is recommended to use the IP address of the server where Immich is running ex `http://my-server-ip:port` or a domain name.
docs: add Immich integration documentation and update configuration menu 2025-01-02 19:00:11 -05:00			`- Paste the API Key you obtained in the previous step.`
			- Click `Enable Immich` to save the settings.
			`3. Now, when you are adding images to an adventure, you will see an option to search for images in Immich or upload from an album.`

			`Enjoy the privacy and control of managing your travel media with Immich and AdventureLog! 🎉`