---
title: "🔧 Settings"
excerpt: "Short explainer where the settings are"
sidebar_position: 4
---

There are three kinds of settings at the moment.

## Profile

You can find your profile settings by clicking in the top right corner and click on `Profile`.

Here you can change your name, photo, e-mail address and preferences regarding thumbnail size, dark mode and language. You can also set if you want your profile to be accessible globally or not.

- `Avatar`, `First name`, `Last name` will be shown if you share pictures with other users or when your profile is publically accessible
- `E-mail` is not used at the moment.
- `Change password` is for changing your password
- `Thumbnail size` will change the size of the pictures in the timeline view
- `Dark mode` will change the theme from light to dark
- `Language` will change the settings
- `Public Sharing` will set if you can be found globally

## Settings

These settings are user specific and will affect how scanning and saving works. At the bottom, you can also find experimental settings.

### Scan Confidence

This setting affect how much certainty is needed for a tag to be added to a picture. Default `Standard`

### Semantic Search

If you set this to `Top 100`,`Top 50`, `Top 10` you will get semantic search results instead of just looking at the EXIF data. It is disabled as default, because the first search takes a minute to get a response. After that it is fast. Default `Disabled`. For more information, see [Search](../search.md).

### Metadata Options

- `Synchronize metadata to disk` can enable the saving of the metadata to file or an xmp file. Default `Off`
- `Minimum image rating to interpret as favorite` will change how favorites are read and saved. EXIF only supports the rating field and does not have a favorite field. Default `4`
- `Default timezone` sets how the exif timestamps should be read and written. Default `UTC`

### Set date & time parsing rules

Here you can set how timestamps are parsed. You can find more information [here](./date-rules)

### Experimental options

Always transcode videos will transcode all videos on demand to h264 to improve compatibility. This is not yet well optimized.

### Slideshow Options

- `Slideshow interval` sets the time in seconds between photos when using slideshow mode in the lightbox.

### Album Options

- `Inferred faces confidence` set the value, which inferred faces need to have to be shown in person albums.

### Scan Options

- `Stack RAW+JPEG` when enabled, RAW and JPEG file pairs with the same basename will be automatically grouped as file variants of a single photo during scanning.

### Public Sharing Defaults

Configure default visibility settings for publicly shared albums. These defaults apply to all new public album shares but can be overridden per-album:

- `Show location` - Whether to display photo location data
- `Show camera info` - Whether to display camera/lens information
- `Show timestamps` - Whether to display photo timestamps
- `Show captions` - Whether to display photo captions
- `Show faces` - Whether to display recognized faces

## Admin Area

These are settings that apply to the whole instance.

## Site Settings

- `Allow user registration` will enable a sign up button on the login page.
- `Allow uploads` sets if uploading should be possible or not
- `Skip patterns` Comma delimited list of patterns to ignore (e.g. '@eaDir,#recycle' for synology devices)
- `Map API Provider` Select which geocoding service to use for converting GPS coordinates to place names. Options include Nominatim (free, no key required), Mapbox, MapTiler, OpenCage, and TomTom.
- `Map API Key` Required only if using a commercial geocoding provider (Mapbox, MapTiler, OpenCage, or TomTom). Not needed for Nominatim.
- `Captioning Model` Select which AI model to use for image captioning. See [Image Captioning](../image-captioning.md).
- `LLM Model` Select which LLM to use for enhanced captioning (None, Mistral, Moondream). When set to "None", no LLM models will be downloaded.
- `Tagging Model` Select which AI model to use for auto-tagging photos. Options:
  - **Places365** — Scene recognition (default). Classifies photos into scene categories like "kitchen", "beach", "forest".
  - **SigLIP 2** — Google's vision-language model using zero-shot classification against a curated vocabulary of 900+ real-world photo tags. Returns the top 10 most relevant tags.
  
  Switching models does not delete previously generated tags. Each model's tags are stored independently, so you can switch back and forth without rescanning.
- `Face Recognition Model` Select which [InsightFace](https://github.com/deepinsight/insightface) model is used to detect and recognise faces. Options:
  - **buffalo_sc** — Lightweight model (default). Fastest and smallest, a good fit for most setups.
  - **buffalo_s** / **buffalo_m** / **buffalo_l** — Progressively larger and more accurate, at the cost of more memory and compute.
  - **antelopev2** — High-accuracy model for the best recognition quality.

  Changing the model downloads the corresponding model files on the next run. After switching, run **Train faces** so all faces are re-encoded with the selected model. See [Face recognition](../face-recognition.md).

## Users

The admin can change here the scan directory and password for users, or add new users to the system.

### Worker Logs

Shows how far jobs are progressed. For more information, go [here](../job-system)
