# Grained

Grained is a self-hosted archive for lab-scanned film that imports scan ZIPs, logs per-roll metadata, and browses frames in a lightbox with per-frame annotations, helping film photographers revisit and share their work. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2861/grained

## Description

Grained is a self-hosted archive for lab-scanned film that imports scan ZIPs, logs per-roll metadata, and browses frames in a lightbox with per-frame annotations, helping film photographers revisit and share their work months or years later.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

35/100 (Low), based on 4 of 4 factors.
- Maintained: 59 (last commit 159 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/grained-1psdz421r9xn12?q=Grained
- GitHub: https://github.com/Revise0592/grained

## Common questions

### Which environment variables must be set before starting Grained in Docker?

You need at least DATABASE_URL and UPLOAD_DIR in your .env file. Those define where the archive database and upload files are stored.

### How do I enable Grained's built-in login?

Set AUTH_DISABLED=false, start the app, then use the login page in the browser on first run to create the admin password. Grained keeps that auth state in the database.

### How can I protect API access separately from the web app?

Add an API_KEY value when you want protected API access. It is used as a bearer token through middleware protection.

### What parts of my archive should I back up?

Back up the database pointed to by DATABASE_URL and the files in UPLOAD_DIR. The upload directory holds original scans and generated files.

### How long are temporary upload files kept before cleanup?

UPLOAD_TEMP_TTL_MS controls the retention time in milliseconds. The default is 86400000 ms.

---
Source: Our Local Host (https://ourlocalhost.com/app/2861/grained), the self-hosted and open-source app directory.
