pastebin

README

Pastebin

A simple, self-hosted pastebin service with S3-compatible storage backend.

Features

• Store and share text snippets with unique URLs
• Configurable time-to-live (TTL) for pastes
• Automatic cleanup of expired pastes
• S3 as the storage backend (AWS S3, MinIO, etc.)
• Data integrity verification on retrieval
• Copy to clipboard functionality
• Raw paste view

Getting started

Running with Docker

docker run -p 8080:8080 \
  -e PASTEBIN_HOST=0.0.0.0 \
  -e PASTEBIN_S3_BUCKET=pastebin \
  -e PASTEBIN_S3_ENDPOINT=your-s3-endpoint:9000 \
  -e PASTEBIN_S3_ACCESS_KEY=your-access-key \
  -e PASTEBIN_S3_SECRET_KEY=your-secret-key \
  ghcr.io/espebra/pastebin:latest

Running with Docker Compose

version: "3"
services:
  s3:
    image: ghcr.io/espebra/stupid-simple-s3:latest
    ports:
      - "5553:5553"
    environment:
      - STUPID_RW_ACCESS_KEY=accesskey
      - STUPID_RW_SECRET_KEY=secretkey
    volumes:
      - s3-data:/var/lib/stupid-simple-s3/
    restart: unless-stopped
  pastebin:
    image: ghcr.io/espebra/pastebin:latest
    ports:
      - "8080:8080"
    environment:
      - PASTEBIN_HOST=0.0.0.0
      - PASTEBIN_S3_BUCKET=pastebin
      - PASTEBIN_S3_ENDPOINT=s3:5553
      - PASTEBIN_S3_USE_SSL=false
      - PASTEBIN_S3_ACCESS_KEY=accesskey
      - PASTEBIN_S3_SECRET_KEY=secretkey
    depends_on:
      - s3
volumes:
  s3-data:

Then run:

docker-compose up

The pastebin service will be available at http://localhost:8080.

Installing from packages

Download the latest .deb or .rpm package from the releases page.

## 1. Install package
# Debian/Ubuntu
sudo dpkg -i pastebin_1.0.0_amd64.deb

# RHEL/Fedora
sudo rpm -i pastebin-1.0.0.x86_64.rpm

## 2. Configure
# Edit /etc/default/pastebin

## 3. Start the service
sudo systemctl enable --now pastebin

Building from source

# Build on your architecture and platform
make build

# Or build for multiple architectures and platforms
make build-all

Configuration

The service is configured using environment variables:

Variable	Description	Default
PASTEBIN_S3_BUCKET	S3 bucket name (required)	-
PASTEBIN_S3_ENDPOINT	S3 endpoint URL	s3.amazonaws.com
PASTEBIN_S3_REGION	S3 region	us-east-1
PASTEBIN_S3_USE_SSL	Use HTTPS for S3	true
PASTEBIN_S3_ACCESS_KEY	S3 access key	-
PASTEBIN_S3_SECRET_KEY	S3 secret key	-
PASTEBIN_HOST	Listen host	127.0.0.1
PASTEBIN_PORT	Listen port	8080
PASTEBIN_MAX_PASTE_SIZE	Maximum paste size in bytes	1048576 (1MB)
PASTEBIN_DEFAULT_TTL	Default paste TTL	8760h (1 year)
PASTEBIN_CLEANUP_INTERVAL	Interval between cleanup runs	1h
PASTEBIN_LOG_FORMAT	Log format (text or json)	text
PASTEBIN_LOG_LEVEL	Log level (debug, info, warn, error)	info
PASTEBIN_SECURE_COOKIES	Set Secure flag on cookies (enable for HTTPS)	false

Check current version

./pastebin --version
# pastebin v1.0.0 (commit: abc1234)

API Endpoints

Method	Path	Description
GET	/	Home page with paste form
POST	/	Create a new paste
GET	/{checksum}	View a paste
GET	/raw/{checksum}	View raw paste content
POST	/delete/{checksum}	Delete a paste
GET	/health	Health check endpoint

Health Check

The /health endpoint returns 200 OK with body OK when the service is running. This can be used for load balancer health checks and monitoring.

curl http://localhost:8080/health
# OK

Storage

Pastes are stored in S3 with the following structure:

• pastes/{checksum} - The paste content
• meta/{checksum}.json - Metadata (created time, expiry, size)

The checksum is the SHA256 hash of the paste content, ensuring deduplication and data integrity verification on retrieval.

Development

Running Tests

make test
make fuzz

Releasing

Releases are automated via GitHub Actions. To create a new release:

git tag v1.0.0
git push origin v1.0.0

The release workflow will automatically:

• Build binaries for Linux (amd64, arm64) and macOS (amd64, arm64)
• Build and push multi-arch Docker images to ghcr.io
• Create a GitHub release with binaries and checksums

License

See LICENSE file.