A modern, feature-rich artifact service with immutable relics, complete version history, and smart content processing. Built with FastAPI (Python), Svelte, and Tailwind CSS.

Relic is a self-hosted pastebin and artifact storage system designed for developers. It goes beyond simple text storage by supporting binary files, archives, images, and providing rich previews for various content types. With a focus on immutability and versioning, Relic ensures your shared snippets and files are safe, trackable, and easy to manage.

• Immutable Artifacts: Each relic is permanent. Edits create new versions via forking with complete history preserved.
• Version Comparison: Visually analyze additions and deletions across text and code lineage through rich diffing.
• Universal Content Support:
  • Code: Integrated Monaco editor and syntax highlighting for 100+ languages.
  • Structured Data: Visually navigate and explore JSON, YAML, TOML, and XML files with an interactive tree viewer.
  • Images: Direct preview support.
  • Archives: Browse ZIP/TAR contents directly in the browser, complete with structured data exploration for embedded files.
  • Documents: PDF rendering, CSV/Excel tables, and Markdown rendering.
  • Diagrams: Integrated Excalidraw support.
• Spaces: Organize relics into curated dynamic collections with access controls and filtering.
• Tagging & Discovery: Easily organize and search relics using tags.
• Bookmarks: Save important relics using the bookmark functionality to easily find them later.
• Comments & Collaboration: Discuss code snippets and collaborate directly on relics.
• CLI Tool: Powerful command-line interface for quick uploads from terminal.
• Relic Indexes: Create file-based curated collections of relics (.rix files).
• Access Control: Public and private relics.
• Expiration: Set relics to expire after 1h, 24h, 7d, 30d, or never.
• Admin Panel: Manage users, view system stats, and moderate content.

Syntax highlighting with line numbers, copy-to-clipboard, and raw view options.

Direct image rendering.

Browse the contents of ZIP and TAR files without downloading them.

Visually navigate and explore JSON, YAML, TOML, and XML structured data directly in the browser.

View recently created public relics or manage your own.

Organize your relics into specialized spaces.

View, search, and manage relics within your curated collections.

Compare and diff changes effortlessly across different text and code versions.

Discuss code snippets and artifacts directly on the relic page.

Monitor system usage, storage, and manage relics.

Relic comes with a powerful CLI tool for terminal-based workflows.

curl -sSL https://your-domain.com/install.sh | bash

# Upload from stdin
echo "Hello World" | relic

# Upload a file
relic myfile.txt

# Upload with options
relic --name "My Script" --private --expires 24h script.py

# Push a relic into a space
relic --space <space_id> script.py

# Manage spaces
relic spaces create "My Cool Space" --visibility public

• Docker and Docker Compose
• Make (optional, but recommended)

For production/release deployments, use the default configuration:

1. Start production services

make up

Or without Make:

docker compose -f docker-compose.prod.yml up -d --build

2. Access the application

• Application: http://localhost
• MinIO Console: http://localhost:9001 (minioadmin/minioadmin)

3. View logs

make logs

4. Stop services

make down

For local development with hot-reload:

1. Start development services

make dev-up

Or without Make:

docker compose -f docker-compose.dev.yml up -d

2. Access the application

• Frontend: http://localhost (with hot-reload)
• Backend: http://localhost/api (with auto-reload)
• API Docs: http://localhost/api/docs
• MinIO Console: http://localhost:9001 (minioadmin/minioadmin)

3. View logs

make dev-logs

4. Stop services

make dev-down

Note: Development mode mounts your local code directories as volumes, enabling hot-reload for both frontend and backend. Changes to code will be reflected immediately without rebuilding.

Relic supports admin users with elevated privileges (view all relics, delete any relic, manage clients, view statistics).

1. Get your Client ID

   Open your browser's Developer Tools (F12) and run this in the Console:

   localStorage.getItem('relic_client_key')

   This will output your client ID, which looks like: 5cdb7b79c38385db9f5b5f6ad884c8ef

2. Configure Admin in Production

   Edit docker-compose.prod.yml and set the ADMIN_CLIENT_IDS environment variable:

   backend:
     environment:
       ADMIN_CLIENT_IDS: "5cdb7b79c38385db9f5b5f6ad884c8ef"

   For multiple admins, use comma-separated values:

   ADMIN_CLIENT_IDS: "5cdb7b79c38385db9f5b5f6ad884c8ef,a1b2c3d4e5f6789012345678abcdef01"

3. Restart Services

   make down
   make up

4. Access Admin Panel

   After restarting, the "Admin" tab will appear in the navigation. Admin privileges include:

   • View all relics (including private ones)
   • Delete any relic (not just your own)
   • View all registered clients
   • Delete clients and their relics
   • View system statistics

For development mode, edit docker-compose.dev.yml instead and use:

make dev-down
make dev-up

Relic indexes (.rix files) allow you to create curated collections of relics.

title: My Project Documentation
description: A collection of documentation files.
relics:
  - id: f47ac10b58cc4372a5670e02b2c3d479
    title: API Reference
  - id: a1b2c3d4e5f678901234567890abcdef

All API endpoints are prefixed with /api/v1.

Create Relic

curl -X POST http://localhost/api/v1/relics \
  -F "[email protected]" \
  -F "name=My File"

Get Relic

curl http://localhost/api/v1/relics/{id}

Fork Relic

curl -X POST http://localhost/api/v1/relics/{id}/fork \
  -F "[email protected]"

• Frontend: Svelte, Tailwind CSS, Vite
• Backend: FastAPI, SQLAlchemy, Pygments
• Storage: PostgreSQL (Metadata), MinIO (Content)
• Infrastructure: Docker, Nginx

MIT