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.

Attic logo

Self-host Attic

v2.8.0

Self-hosted home inventory management

ReleaseOpen SourceMIT
Updated10 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
160
Port
8080 (HTTP server)
Docker
ghcr.io/lmmendes/attic
Install with Docker Compose
Attic home inventory dashboard in light modeAttic home inventory dashboard in dark mode

What is Attic?

Attic is a self-hosted application for tracking household belongings. It uses hierarchical locations like rooms, shelves, and boxes, along with categories that support custom fields. Features include warranty monitoring, file attachments for receipts and manuals, collections for grouping items, and advanced search with nested filters. The software integrates with external databases to fetch metadata and cover images automatically. Deployment options include Docker Compose, standalone Docker, or Kubernetes, requiring PostgreSQL 16+ and offering local or S3-compatible storage. Authentication supports local passwords and OIDC/SSO with providers like Keycloak, Authentik, and PocketID. The project is MIT-licensed and actively developed.

Should you self-host Attic?

Attic scores 48/100 on selfhost.directory (how scoring works) and ranks #9 of 15 in Home Management. It has 160 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v2.8.0, came out on 26 October 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 Go.

Its closest alternative on selfhost.directory is yuvomi (76/100, 2 068 stars). It scores higher overall, so compare the two before you pick. See Attic vs yuvomi side by side.

Features

  • Advanced search and filtering
  • Automated metadata imports
  • Collections
  • Condition tracking
  • Configurable workspace
  • File attachments
  • Home inventory management
  • Local password authentication
  • OIDC/SSO Authentication
  • REST API with Swagger documentation
  • Warranty Tracking

Attic README

How to install Attic

Install Attic with Docker Compose

Docker & Docker Compose
Environment variables
POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, ATTIC_SESSION_SECRET, ATTIC_BASE_URL, ATTIC_ADMIN_EMAIL, ATTIC_ADMIN_PASSWORD, ATTIC_OIDC_*, ATTIC_S3_*, ATTIC_GOOGLE_BOOKS_API_KEY, ATTIC_TMDB_API_KEY, ATTIC_BGG_API_KEY, ATTIC_IGDB_CLIENT_ID, ATTIC_IGDB_CLIENT_SECRET, ATTIC_PUID, ATTIC_PGID

mkdir attic && cd attic

Create docker-compose.yml with attic and postgres services

Create .env with configuration

docker compose up -d

Recommended installation method

How to configure Attic

  • ATTIC_AUTH_DISABLEDOptional: Disable auth for development

    Optional: Disable auth for development

  • ATTIC_AUTH_DISABLED_USER_EMAIL
  • ATTIC_BASE_URL
  • ATTIC_BGG_API_KEY
  • ATTIC_CORS_ORIGINS
  • ATTIC_GOOGLE_BOOKS_API_KEYImport Plugin API Keys Google Books can work without a key, but a key avoids the shared anonymous quota

    Import Plugin API Keys Google Books can work without a key, but a key avoids the shared anonymous quota

  • ATTIC_IGDB_CLIENT_IDIGDB requires both credentials from a Twitch application

    IGDB requires both credentials from a Twitch application

  • ATTIC_IGDB_CLIENT_SECRET
  • ATTIC_LOCAL_STORAGE_PATHLocal Storage Configuration Used when S3 credentials are not configured

    Local Storage Configuration Used when S3 credentials are not configured

  • ATTIC_OIDC_AUTO_REDIRECTfalseOptional: immediately forward unauthenticated users to the OIDC provider

    Optional: immediately forward unauthenticated users to the OIDC provider

  • ATTIC_OIDC_CLIENT_IDattic-web
  • ATTIC_OIDC_CLIENT_SECRET
  • ATTIC_OIDC_ISSUER_URLOIDC/Keycloak Configuration

    OIDC/Keycloak Configuration

  • ATTIC_PGID
  • ATTIC_PORTOptional: Backend Configuration

    Optional: Backend Configuration

  • ATTIC_PUIDFile ownership (useful in Docker containers) Set PUID/PGID to match your host user for proper file permissions Find your user ID with: id -u Find your group ID with: id -g

    File ownership (useful in Docker containers) Set PUID/PGID to match your host user for proper file permissions Find your user ID with: id -u Find your group ID with: id -g

  • ATTIC_S3_ACCESS_KEY
  • ATTIC_S3_BUCKET
  • ATTIC_S3_ENDPOINThttps://s3.amazonaws.comS3/Object Storage Configuration For AWS S3

    S3/Object Storage Configuration For AWS S3

  • ATTIC_S3_REGIONus-east-1
  • ATTIC_S3_SECRET_KEY
  • ATTIC_SESSION_SECRET
  • ATTIC_TMDB_API_KEY
  • KEYCLOAK_ADMIN
  • KEYCLOAK_ADMIN_PASSWORD
  • KEYCLOAK_DB
  • KEYCLOAK_HOSTNAMEKeycloak Admin (for production setup)

    Keycloak Admin (for production setup)

  • OIDC_SESSION_SECRETFrontend Session Configuration Generate with: openssl rand -base64 48

    Frontend Session Configuration Generate with: openssl rand -base64 48

  • OIDC_TOKEN_KEY
  • POSTGRES_DBattic
  • POSTGRES_PASSWORD
  • POSTGRES_USERatticDatabase Configuration

    Database Configuration

Attic releases & version history

More in Home Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…