Photoprism Setup Guide

Introduction

Photoprism is a self-hosted photo management application that helps you browse, organize, and share your photos and videos. It uses machine learning to automatically tag and categorize your images.

Prerequisites

• Docker installed
• Photoprism container running in your Docker stack

Configuration Steps

Step 1: Accessing the Photoprism UI

1. Open your browser and navigate to http://<your-ip-address>:2342.
2. Log in with your Photoprism credentials.

Step 2: Initial Setup Wizard

1. Follow the initial setup wizard to configure basic settings.
2. Choose your preferred language for the Photoprism interface.

Step 3: Adding Photo Libraries

1. Navigate to the Library tab.
2. Click Add Folder.
3. Enter the path to your photo library folder.
4. Click Save.

Step 4: Configuring Indexing

1. Go to the Settings tab.
2. Navigate to the Indexing section.
3. Configure the indexing settings according to your preferences (e.g., automatic indexing, face recognition).
4. Click Save.

Step 5: Adding Tags and Categories

1. Navigate to the Tags tab.
2. Click Add Tag.
3. Enter the tag name and description.
4. Click Save.
5. Repeat this process to create categories for organizing your photos.

Step 6: Customizing Settings

1. Go to the Settings tab.
2. Customize settings such as display options, privacy settings, and backup preferences.
3. Click Save.

Notes

• Ensure all paths and environment variables are updated in the photoprism.yaml file.
• Regularly backup your config directory to save your settings and photo library.

Troubleshooting

• Common Issues: List common issues and solutions.
• Logs: Check Photoprism logs for error messages.
• Support: Link to the Photoprism community and support resources.