w3kllc/microbin repository overview

⁠MicroBin — w3K Edition

A fast, self-hosted, privacy-first pastebin and file-sharing service written in Rust. Share text snippets, upload files, set optional passwords, custom URLs, and expiry times — entirely self-contained, no external dependencies, no tracking.

This is the w3K fork of MicroBin⁠, with production-hardened defaults and additional features. Live at microbin.cc⁠.

⁠What's Different in This Fork

⁠Quick Start

docker run -d \
  -p 8080:8080 \
  -e MICROBIN_PUBLIC_PATH=https://paste.example.com \
  -v microbin-data:/app/microbin_data \
  --name microbin \
  w3kllc/microbin:latest

Visit http://localhost:8080 — admin panel at http://localhost:8080/@.

⁠Supported Platforms

• linux/amd64 — Intel/AMD 64-bit (desktops, servers, cloud VMs)
• linux/arm64 — ARM 64-bit (Raspberry Pi 4+, Apple Silicon, AWS Graviton, Oracle Cloud)

Docker pulls the correct image for your platform automatically.

⁠Docker Compose

services:
  microbin:
    image: w3kllc/microbin:latest
    container_name: microbin
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - microbin-data:/app/microbin_data
    environment:
      - MICROBIN_PORT=8080
      - MICROBIN_PUBLIC_PATH=https://paste.example.com
      - MICROBIN_ADMIN_USERNAME=admin
      - MICROBIN_ADMIN_PASSWORD=changeme
      - MICROBIN_QR=true
      - MICROBIN_ETERNAL_PASTA=true
      - MICROBIN_HASH_IDS=true
      - MICROBIN_DISABLE_TELEMETRY=true

volumes:
  microbin-data:

⁠With a reverse proxy (Traefik)

services:
  microbin:
    image: w3kllc/microbin:latest
    container_name: microbin
    restart: unless-stopped
    volumes:
      - microbin-data:/app/microbin_data
    environment:
      - MICROBIN_PUBLIC_PATH=https://paste.example.com
      - MICROBIN_ADMIN_USERNAME=admin
      - MICROBIN_ADMIN_PASSWORD=changeme
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.microbin.rule=Host(`paste.example.com`)"
      - "traefik.http.routers.microbin.entrypoints=websecure"
      - "traefik.http.routers.microbin.tls.certresolver=letsencrypt"
      - "traefik.http.services.microbin.loadbalancer.server.port=8080"

volumes:
  microbin-data:

⁠With Nginx Proxy Manager / CloudPanel

Point your domain to the container's port 8080. Set MICROBIN_PUBLIC_PATH to your full public URL including https://.

⁠Configuration

*Defaults differ from upstream — set by this fork.

⁠Privacy Levels

⁠Expiry Options

1min · 10min · 1hour · 24hour · 3days · 1week · never

⁠Admin Panel

Access at <your-url>/@ — sign in with your configured username and password.

The admin panel lists all pastes regardless of privacy level, allows deletion, and shows server status and version info.

⁠HTML File Rendering

Upload any .html or .htm file and it renders inline in the browser instead of downloading. A small non-printable navigation button (bottom-right) links back to MicroBin. The button is hidden automatically when printing or saving as PDF.

This makes MicroBin useful for sharing formatted documents — resumes, reports, proposals — with or without a password, at a clean custom URL.

microbin.cc/juanitaresume          # public — visit and read
microbin.cc/q4report               # unlisted — share link to read
microbin.cc/contractdraft          # private — password required

⁠Custom URLs

Set a custom URL slug when creating a paste. It persists across all operations including auth redirects, incorrect-password flows, edit, and remove.

URLs must be alphanumeric with hyphens/underscores, max 100 characters.

⁠Image Tags

⁠Building Locally

# Single platform
docker build -t microbin:local .

# Multi-platform (requires buildx)
docker buildx build --platform linux/amd64,linux/arm64 -t microbin:local .

# From source (Rust)
cargo build --release
./target/release/microbin --port 8080

⁠Links

• Live instance: microbin.cc⁠
• Fork repository: github.com/w3K-one/microbin⁠
• Docker Hub: hub.docker.com/r/w3kllc/microbin⁠
• Upstream project: github.com/szabodanika/microbin⁠

⁠License

BSD-3-Clause — see LICENSE⁠.