Files
echo/.references/references-only/reference vault/memory/projects/memer.md
T
2026-06-05 00:49:20 -05:00

2.3 KiB

type, status, source, repo, repo_url, language, branch, tags, updated
type status source repo repo_url language branch tags updated
project active git.alwisp.com jason/memer https://git.alwisp.com/jason/memer TypeScript main
repo
jason
2026-05-29

memer

Repository: jason/memer · branch main · TypeScript

Summary

Self-hosted meme gallery with quick-share for SMS and Telegram — Dockerized masonry grid with tag search, upload, and non-destructive image rescaling

Current status

Active. Synced from Gitea on 2026-05-29.

Documentation overview

Memer

A self-hosted meme gallery with quick-share for text message and Telegram. Runs as a single Docker container, designed for Unraid.

Features

  • Masonry gallery — responsive, dark-themed grid
  • Upload — drag & drop or click, supports JPG/PNG/GIF/WebP (up to 100 MB)
  • Tags — organize with comma-separated tags, filter by tag in the gallery
  • Search — full-text search across titles and descriptions
  • Quick share — copy link, Telegram, SMS, or download from any card or detail view
  • Non-destructive rescale — creates a child image at a new size without touching the original
  • Persistent — SQLite database + image files on Docker volumes (easy to back up or export)

Quick Start

cp .env.example .env
# Edit .env: set PUBLIC_URL to your domain
docker compose up --build -d

Open http://localhost:3000.

Unraid Setup

  1. In Unraid, go to Docker > Add Container (or use Community Applications).
  2. Use the image memer:latest (build locally or push to a registry).
  3. Map port 3000 to your desired host port.
  4. Add two path mappings:
    • /data/images/mnt/user/appdata/memer/images
    • /data/db/mnt/user/appdata/memer/db
  5. Set environment variable PUBLIC_URL to https://meme.alwisp.com.
  6. Set up your reverse proxy (Nginx Proxy Manager, Swag, etc.) to point meme.alwisp.com → port 3000.

Environment Variables

Variable Default Description
PUBLIC_URL http://localhost:3000 Used to build absolute share links
PORT 3000 Port the server listens on
DATA_DIR /data Root for images and DB inside the container

API

Method Path Description

…(truncated — see repo)

Notes

  • Project file auto-created from repo documentation.