Self-Hosting Guide

BentoPDF can be self-hosted on your own infrastructure. This guide covers various deployment options.

Quick Start with Docker

The fastest way to self-host BentoPDF:

docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf:latest

Or with Docker Compose:

# docker-compose.yml
services:
  bentopdf:
    image: ghcr.io/alam00000/bentopdf:latest
    ports:
      - "3000:8080"
    restart: unless-stopped

docker compose up -d

Building from Source

# Clone and build
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf
npm install
npm run build

# The built files are in the `dist` folder

Configuration Options

Simple Mode

Simple Mode is designed for internal organizational use where you want to hide all branding and marketing content, showing only the essential PDF tools.

What Simple Mode hides:

Navigation bar
Hero section with marketing content
Features, FAQ, testimonials sections
Footer
Updates page title to "PDF Tools"

# Build with Simple Mode
SIMPLE_MODE=true npm run build

# Or use the pre-built Docker image
docker run -p 3000:8080 bentopdf/bentopdf-simple:latest

See SIMPLE_MODE.md for full details.

Base URL

Deploy to a subdirectory:

BASE_URL=/pdf-tools/ npm run build

Deployment Guides

Choose your platform:

Vercel
Netlify
Cloudflare Pages
AWS S3 + CloudFront
Hostinger
Nginx
Apache
Docker
Kubernetes
CORS Proxy - Required for digital signatures

System Requirements

Requirement	Minimum
Storage	~500 MB (with all WASM modules)
RAM	512 MB
CPU	Any modern processor

::: tip BentoPDF is a static site—there's no database or backend server required! :::

2.1 KiB Raw Blame History