Simple Mode is designed for organizations that want a focused, internal-use interface. It removes all branding and marketing chrome from the UI and shows only the PDF tool cards with a search bar.
What Simple Mode changes
Hidden in Simple Mode Navigation bar, hero section, features section, FAQ section, testimonials section, support section, and footer are all hidden.
Shown in Simple Mode All PDF tool cards organized by category, search bar, page title “PDF Tools”, and “Select a tool to get started” subtitle.
SIMPLE_MODE=true is a build-time setting. It cannot be toggled at runtime. Use the pre-built bentopdf-simple image or rebuild with the flag set.
How to enable Simple Mode
Choose your method
Pick the approach that matches your deployment setup.
Enable and deploy
Follow the instructions for your chosen method below.
Method 1: Pre-built Docker image (recommended) The easiest option — pull the pre-built Simple Mode image and run it directly:
GHCR (recommended)
Docker Hub
Podman (GHCR)
docker run -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest
Method 2: Docker Compose Use the Simple Mode image in a Compose file for auto-restart and easier management:
services : bentopdf : image : ghcr.io/alam00000/bentopdf-simple:latest # image: bentopdfteam/bentopdf-simple:latest # Alternative: Docker Hub container_name : bentopdf restart : unless-stopped ports : - '3000:8080'
Method 3: Docker build argument Build your own image with Simple Mode enabled:
docker build --build-arg SIMPLE_MODE= true -t bentopdf-simple . docker run -p 3000:8080 bentopdf-simple
Method 4: npm script For local development, use the built-in npm script that builds and serves Simple Mode automatically:
This sets SIMPLE_MODE=true, builds the project, and serves it at http://localhost:3000.
Method 5: Environment variable Set the environment variable before running a manual build:
SIMPLE_MODE = true npm run build npx serve dist -p 3000
Available container images Mode GHCR Docker Hub Normal (full interface) ghcr.io/alam00000/bentopdf:latestbentopdfteam/bentopdf:latestSimple (tools only) ghcr.io/alam00000/bentopdf-simple:latestbentopdfteam/bentopdf-simple:latest
Versioned tags are available for both images, for example ghcr.io/alam00000/bentopdf-simple:v1.0.0.
Podman Quadlet (systemd service) To run Simple Mode as a persistent systemd service on Linux using Podman Quadlet, create ~/.config/containers/systemd/bentopdf-simple.container:
[Unit] Description =BentoPDF Simple Mode After =network-online.target [Container] Image =ghcr.io/alam00000/bentopdf-simple:latest ContainerName =bentopdf-simple PublishPort =80:8080 AutoUpdate =registry [Service] Restart =always [Install] WantedBy =default.target
Then enable and start the service:
systemctl --user daemon-reload systemctl --user enable --now bentopdf-simple
Combining Simple Mode with other options Simple Mode can be combined with custom branding and other build-time settings:
docker build \ --build-arg SIMPLE_MODE= true \ --build-arg VITE_BRAND_NAME="AcmePDF" \ --build-arg BASE_URL=/pdf-tools/ \ -t acmepdf-simple .
All PDF tools work identically in Simple Mode. The only difference is the UI chrome around the tool cards.
