Eyeris

Overview

Self-hosted photo manager for NAS and local libraries. Eyeris scans your photos, generates thumbnails, and gives you a fast searchable gallery — all on your own hardware. AI-powered image descriptions and tagging are offloaded to a connected A-Eye instance; Eyeris imports the results automatically. No cloud, no subscriptions, no local LLM required. Features include: A-Eye integration for AI descriptions and tags, EXIF and GPS metadata, duplicate and blurry photo detection, album organisation, SearXNG web image search, and a real-time dashboard.

Requirements

Optional but recommended: a running A-Eye instance for AI image descriptions and tagging. Optional: MariaDB for large libraries (SQLite used by default).

Runtime arguments

Web UI: http://[IP]:[PORT:8000]/
Network: bridge
Shell: bash
Privileged: false

Template configuration

Web UI PortPorttcp

Port for the Eyeris web interface and API.

Target: 8000
Default: 8000
Value: 8000

Photo DirectoryPathrw

Your photo library — local folder or SMB/NFS mount point.

Target: /data/images
Default: /mnt/user/Pictures/
Value: /mnt/user/Pictures/

ThumbnailsPathrw

Where Eyeris stores generated thumbnails and face crop cache.

Target: /data/thumbnails
Default: /mnt/user/appdata/eyeris/thumbnails/
Value: /mnt/user/appdata/eyeris/thumbnails/

DatabasePathrw

SQLite database storage. Ignored if DB_HOST is set.

Target: /data/db
Default: /mnt/user/appdata/eyeris/db/
Value: /mnt/user/appdata/eyeris/db/

Config file (.env)Pathrw

Persistent config file — Eyeris reads and writes settings here. Create an empty file at this path before first run.

Target: /app/.env
Default: /mnt/user/appdata/eyeris/eyeris.env
Value: /mnt/user/appdata/eyeris/eyeris.env

NAS HostVariable

IP or hostname of your NAS. Leave empty if photos are already accessible via the Photo Directory path above.

Target: SMB_HOST

NAS UsernameVariable

SMB/CIFS username for your NAS.

Target: SMB_USERNAME

NAS PasswordVariable

SMB/CIFS password for your NAS.

Target: SMB_PASSWORD

NAS SharesVariable

Comma-separated share names to scan, e.g. photos,media,camera-uploads

Target: SMB_SHARES

A-Eye URLVariable

URL of your A-Eye instance, e.g. http://192.168.1.100:7171. Connect A-Eye to enable AI image descriptions and automatic tagging.

Target: AEYE_URL

A-Eye UsernameVariable

Username for HTTP Basic Auth on your A-Eye instance. Leave empty if A-Eye is unauthenticated.

Target: AEYE_USER

A-Eye PasswordVariable

Password for HTTP Basic Auth on your A-Eye instance.

Target: AEYE_PASS

SearXNG URLVariable

URL of a SearXNG instance for the web image search feature (optional).

Target: SEARXNG_URL

Scan WorkersVariable

Number of parallel scan workers. Raise to 3-4 on fast systems; lower if your system struggles.

Target: SCAN_CONCURRENCY
Default: 2
Value: 2

Scan Interval (minutes)Variable

How often Eyeris rescans for new photos.

Target: SCAN_INTERVAL_MINUTES
Default: 60
Value: 60

Scan Schedule EnabledVariable

Set to true to restrict scanning to a time window (e.g. overnight only).

Target: SCAN_SCHEDULE_ENABLED
Default: false
Value: false

Scan Schedule StartVariable

Start of the allowed scan window (24-hour HH:MM). Only used when SCAN_SCHEDULE_ENABLED=true.

Target: SCAN_SCHEDULE_START
Default: 22:00
Value: 22:00

Scan Schedule EndVariable

End of the allowed scan window (24-hour HH:MM). An end time before the start time crosses midnight.

Target: SCAN_SCHEDULE_END
Default: 06:00
Value: 06:00

MariaDB HostVariable

MariaDB host IP or hostname. Leave empty to use the built-in SQLite database (recommended for most users).

Target: DB_HOST

MariaDB PortVariable

MariaDB port.

Target: DB_PORT
Default: 3306
Value: 3306

MariaDB UserVariable

MariaDB username.

Target: DB_USER
Default: root
Value: root

MariaDB PasswordVariable

MariaDB password.

Target: DB_PASSWORD

MariaDB DatabaseVariable

MariaDB database name.

Target: DB_NAME
Default: image_catalog
Value: image_catalog

Links

Template Support Registry Project

Details

Repository

ghcr.io/vonhex/eyeris:latest

Registry

https://github.com/vonhex/Eyeris/pkgs/container/eyeris

Last Updated2026-06-01

First Seen2026-05-04

Run Eyeris on Unraid.

Eyeris is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS