DPTCloud
Back to articles
Technology Insight

Self-Hosting MicroBin on a VPS: The Ultimate Guide to a Private, Ultra-Fast Pastebin Alternative

May 29, 2026

Introduction: The Growing Need for Private Code Sharing

In the modern digital landscape, sharing code snippets, server logs, and configuration files is a daily necessity for developers, system administrators, and DevOps teams. For years, public platforms like Pastebin or GitHub Gists have been the default solutions. However, for businesses and privacy-conscious professionals, relying on public third-party services introduces significant compliance risks, potential data leaks, and dependency on external uptime.

When you accidentally paste a snippet containing an API key, database credential, or proprietary business logic onto a public platform, the damage can be catastrophic. This is where self-hosting becomes a game-changer. By deploying your own lightweight pastebin service on a Virtual Private Server (VPS), you maintain absolute control over your data, access permissions, and retention policies. Among the various self-hosted options available today, MicroBin stands out as one of the most efficient, secure, and feature-rich solutions.

What is MicroBin?

MicroBin is a minimalist, ultra-fast, and highly customizable self-hosted pastebin application written in Rust. Unlike resource-heavy alternatives, MicroBin is designed with efficiency in mind, requiring negligible CPU and RAM, making it perfect for deployment on cost-effective VPS instances.

Key features that make MicroBin an enterprise-ready choice include:

  • Zero External Dependencies: It runs out of a single executable or a lightweight Docker container without requiring a heavy database like PostgreSQL or MySQL.
  • Advanced Privacy Controls: Supports encrypted pastes, self-destructing links (burn-on-read), and expiration timers.
  • File Upload Support: Beyond text and code snippets, it can handle small file attachments and images.
  • Syntax Highlighting: Native support for dozens of programming languages, ensuring readability for development teams.
  • QR Code Generation: Easily share links to mobile devices via automatically generated QR codes.

Prerequisites for Deployment

Before initiating the installation process, ensure you have the following components ready:

  1. A VPS Instance: A basic server from providers like DigitalOcean, Linode, Vultr, or Hetzner running Ubuntu 22.04 LTS or later. A single vCPU and 1GB of RAM is more than enough.
  2. A Domain or Subdomain: A domain (e.g., paste.yourcompany.com) pointed to your VPS IP address via an A record.
  3. Docker and Docker Compose: The easiest way to deploy and manage MicroBin sustainably.
  4. Reverse Proxy: Nginx or Caddy to handle SSL encryption (HTTPS) securely.

Step-by-Step Guide: Deploying MicroBin via Docker Compose

Deploying MicroBin using Docker Compose guarantees portability and straightforward updates. Follow these structured steps to get your service operational.

Step 1: Access Your VPS and Setup the Directory

Connect to your server via SSH and create a dedicated directory for your MicroBin deployment to keep your file system organized.

ssh root@your_vps_ip
mkdir -p /opt/microbin
cd /opt/microbin

Step 2: Create the Docker Compose Configuration

Create a docker-compose.yml file using your preferred text editor:

nano docker-compose.yml

Paste the following optimized configuration into the file:

Security Note: Always customize your environmental variables, particularly server secrets and administrator credentials, before moving to a production environment.

version: '3.8'

services:
  microbin:
    image: m0606/microbin:latest
    container_name: microbin
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./microbin-data:/app/microbin_data
    environment:
      - MICROBIN_HIGHLIGHTSERVER=true
      - MICROBIN_QRCODE=true
      - MICROBIN_EDITABLE=true
      - MICROBIN_PRIVATE=false
      - MICROBIN_HIDE_FOOTER=true
      - MICROBIN_HELP_PAGE=false
      - MICROBIN_ENCRYPTION_CLIENT_SIDE=true

Save and exit the file (in Nano, press Ctrl+O, Enter, then Ctrl+X).

Step 3: Launch the Container

Execute the Docker Compose command to pull the image and launch MicroBin in detached mode:

docker compose up -d

Verify that the container is running smoothly by checking the logs:

docker compose logs -f microbin

Securing Your Instance with Nginx and Let's Encrypt

Exposing port 8080 directly to the internet over HTTP leaves your data vulnerable to interception. To implement corporate-grade security, we must wrap our service in an Nginx reverse proxy secured by Let's Encrypt SSL certificates.

Step 1: Install Nginx and Certbot

Install the required packages on your Ubuntu host:

sudo apt update
sudo apt install nginx certbot python3-certbot-nginx -y

Step 2: Configure the Nginx Server Block

Create a new configuration file for your subdomain:

sudo nano /etc/nginx/sites-available/microbin

Insert the following reverse proxy configuration:

server {
    listen 80;
    server_name paste.yourcompany.com;

    location / {
        proxy_pass [http://127.0.0.1:8080](http://127.0.0.1:8080);
        proxy_set_header Host $$host;
        proxy_set_header X-Real-IP $$remote_addr;
        proxy_set_header X-Forwarded-For $$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $$scheme;
        
        # Allow larger file uploads if you use the file sharing feature
        client_max_body_size 50M;
    }
}

Link the configuration to the enabled sites and restart Nginx:

sudo ln -s /etc/nginx/sites-available/microbin /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Step 3: Generate the SSL Certificate

Run Certbot to automate the SSL acquisition and configuration process:

sudo certbot --nginx -d paste.yourcompany.com

Follow the on-screen prompts to complete the process. Certbot will automatically redirect all HTTP traffic to secure HTTPS traffic.

Optimizing MicroBin for Enterprise Workflows

To maximize the utility of your new self-hosted pastebin alternative within a business environment, consider enforcing these configurations:

  • Client-Side Encryption: Ensure MICROBIN_ENCRYPTION_CLIENT_SIDE=true is set. This guarantees that even if an attacker gains physical access to the VPS storage, the contents of the pastes remain encrypted and unreadable without the specific URL key generated on creation.
  • Data Retention Policies: Prevent your server storage from bloating over time. Encourage your team to utilize the "Burn on Read" feature for sensitive keys, or set a default expiration period (e.g., 24 hours or 7 days) via environmental variables.
  • Global Accessibility vs. VPN: If your team works strictly via a corporate network or VPN, restrict port access through your VPS firewall (UFW) to allow requests only from specific internal IP addresses.

Conclusion and Next Steps

Self-hosting MicroBin on a VPS is an elegant, cost-effective, and highly secure alternative to relying on public paste utilities. It minimizes the risk of shadow IT within your organization and provides engineers with a fast, reliable mechanism to collaborate without compromising confidentiality. By following this guide, you have moved your code sharing infrastructure in-house, optimizing both operational efficiency and data sovereignty.

Self-Hosting MicroBin on a VPS: The Ultimate Guide to a Private, Ultra-Fast Pastebin Alternative | DPTCloud