The fastest way to run BentoPDF is with Docker. Pick the option that fits your setup.
Option 1: Docker (recommended)
Pull and run the image
Run a single command to start BentoPDF from the GitHub Container Registry: docker run -p 3000:8080 ghcr.io/alam00000/bentopdf:latest
Alternatively, use the Docker Hub image: docker run -p 3000:8080 bentopdfteam/bentopdf:latest
Option 2: Docker Compose Docker Compose gives you auto-restart and easier configuration management.
Create a docker-compose.yml file
services : bentopdf : # GitHub Container Registry (Recommended) # simple mode - ghcr.io/alam00000/bentopdf-simple:latest # default mode - ghcr.io/alam00000/bentopdf:latest # Docker Hub (Alternative) # simple mode - bentopdfteam/bentopdf-simple:latest # default mode - bentopdfteam/bentopdf:latest image : ghcr.io/alam00000/bentopdf-simple:latest container_name : bentopdf restart : unless-stopped ports : - '8080:8080' # For IPv4-only environments #environment: # - DISABLE_IPV6=true
Start the container
Docker Compose
Podman Compose
Option 3: Build from source If you prefer to build BentoPDF yourself:
Clone the repository
git clone https://github.com/alam00000/bentopdf.git cd bentopdf
You need Node.js v18 or higher. Run node --version to check your version.
SharedArrayBuffer and HTTPS Office file conversions (Word, Excel, PowerPoint) require SharedArrayBuffer, which browsers only enable in a secure context .
http://localhost works for local testing — browsers treat loopback as trustworthy.http://192.168.x.x and other LAN IPs require HTTPS, even if your server sends the correct Cross-Origin-Opener-Policy and Cross-Origin-Embedder-Policy headers. If you access BentoPDF from another device on your network, set up HTTPS on your server to enable Office conversions. Next steps
Tools overview Browse all 130+ tools across every PDF category.
Self-hosting Configure Docker, static platforms, air-gapped deployments, and more.
Custom branding Replace the default logo, name, and footer with your own.
