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

# memer

**Repository:** [jason/memer](https://git.alwisp.com/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

```bash
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.