selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Urocissa logo

Self-host Urocissa

3.4.2

High-performance photo gallery for massive collections

ReleaseOpen SourceMIT
Updated12 hours ago
LanguageRust
Setup difficultyModerate
MobileResponsive
Stars
300
RAM
4 GB
Port
5673 (HTTP server)
Requires
Ffmpeg
Docker
hsa00000/urocissa
Install with Docker
Urocissa gallery interface showing photo grid

What is Urocissa?

Urocissa is a self-hosted photo and video gallery built for massive collections, handling millions of media files on modest hardware. The Rust backend and Vue 3 frontend use an in-memory cached database to deliver instant boolean search, endless virtual scrolling without pagination, and a responsive layout. Deployment options include Docker, standalone executables for Windows and Linux, and building from source. Core capabilities cover upload and download, EXIF metadata preservation, custom tags, duplicate detection, shareable albums, image rotation, auto-backup of watched folders, read-only mode, and timeline navigation. Current gaps include no multi-user support, no face or object recognition, no map view, and no native mobile apps. The project is MIT-licensed and sees regular releases.

Should you self-host Urocissa?

Urocissa scores 48/100 on selfhost.directory (how scoring works) and ranks #11 of 19 in Photo Galleries. It has 300 GitHub stars.

It shipped 18 stable releases in the past year. The latest, 3.4.2, came out on 21 September 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is Immich (93/100, 117 509 stars). It scores higher overall, so compare the two before you pick. See Urocissa vs Immich side by side.

Features

  • Auto backup folders
  • Download photos and videos
  • Duplicate handling
  • EXIF data preservation
  • Image rotation
  • Infinite virtual scrolling
  • In-memory cached database
  • Instant boolean search
  • Instant select all
  • Read-Only Mode
  • Shareable albums
  • Timeline navigation
  • Upload photos and videos
  • User-defined tags

Urocissa README

How to install Urocissa

Install Urocissa with Docker

Docker

git clone https://github.com/hsa00000/urocissa.git cd urocissa bash run_urocissa_docker.sh

Access at http://127.0.0.1:5673

How to configure Urocissa

  • address0.0.0.0The IP address the server binds to. "0.0.0.0" means it listens on all available network interfaces.

    The IP address the server binds to. "0.0.0.0" means it listens on all available network interfaces.

  • authKeyThe secret key used for signing authentication tokens (JWT). If null, a random key is generated on every startup.

    The secret key used for signing authentication tokens (JWT). If null, a random key is generated on every startup.

  • disableImgfalseIf set to true, disables image processing features in the frontend. Intended for debugging purposes only.

    If set to true, disables image processing features in the frontend. Intended for debugging purposes only.

    values: true, false

  • discordHookUrlOptional Discord Webhook URL for receiving system notifications and error reports.

    Optional Discord Webhook URL for receiving system notifications and error reports.

  • limits.data-form10GiBMaximum allowed size for multipart form data submissions.

    Maximum allowed size for multipart form data submissions.

  • limits.file10GiBMaximum allowed size for a single file upload.

    Maximum allowed size for a single file upload.

  • limits.json10MiBMaximum allowed size for JSON request bodies.

    Maximum allowed size for JSON request bodies.

  • passwordThe password required to log in to the web interface. If null, no password is set.

    The password required to log in to the web interface. If null, no password is set.

  • port5673The port number the server listens on.

    The port number the server listens on.

  • readOnlyModefalseIf set to true, the gallery runs in read-only mode. Uploads, edits, and deletions are disabled.

    If set to true, the gallery runs in read-only mode. Uploads, edits, and deletions are disabled.

    values: true, false

Urocissa releases & version history

More in Photo Galleries

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…