Aperture

Aperture

Docker app from grtgbln's Repository

Overview

Aperture creates personalized recommendation libraries for your Emby and Jellyfin media server users using OpenAI embeddings and pgvector similarity search. Recommendations appear as virtual libraries in your media server's home screen, with support for both movies and TV series.

Requirements


        Requires separate Jellyin/Emby media servers and pgvector database instances.
    

Runtime arguments

Web UI
http://[IP]:[PORT:3456]/
Network
bridge
Privileged
false
Extra Params
--user 099:100

Template configuration

Web UI PortPorttcp

Container Port: 3456

Target
3456
Default
3456
Value
3456
Database URLVariable

Database connection URL

Target
DATABASE_URL
Default
postgresql://aperture:password@IP_ADDRESS:5432/aperture
Value
postgresql://aperture:password@IP_ADDRESS:5432/aperture
Base URLVariable

Base URL for accessing the application

Target
APP_BASE_URL
Default
http://IP_ADDRESS:3456
Value
http://IP_ADDRESS:3456
Session SecretVariable

Secret key, at least 32 characters

Target
SESSION_SECRET
Aperture Libraries PathPath

Path where Aperture libraries will be stored. Should be inside your existing media server's library path.

Target
/aperture-libraries
Media Libraries PathPathro

Path to the root of your media library.

Target
/media
Backups PathPath

Path where backups will be stored

Target
/backups
Default
/mnt/user/appdata/aperture/backups
Value
/mnt/user/appdata/aperture/backups
Run Migrations on StartVariable

Whether to run database migrations on container start

Target
RUN_MIGRATIONS_ON_START
Default
true|false
Node EnvironmentVariable

Set the Node environment. Not recommended to change.

Target
NODE_ENV
Default
production
Value
production
Internal PortVariable

Internal port the application listens on. Not recommended to change.

Target
PORT
Default
3456
Value
3456

Details

Repository
ghcr.io/dgruhin-hrizn/aperture:latest
Last Updated2026-05-31
First Seen2026-01-17

Run Aperture on Unraid.

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