Stirling-PDF

Edit, merge, split, convert, sign and OCR PDF files in your browser.

  • stirlingtools/stirling-pdf:3.3.0
  • v3.3.0
  • Updated 16 Nov 2026
  • port 6736
  • amd64 · arm64
  • Productivity
  • 97.2k stars

Screenshots

Stirling-PDF screenshot 1: ToolsStirling-PDF screenshot 2: Light theme

Open the app

Web UI

http://localhost:6736/

About Stirling-PDF

Stirling-PDF is a PDF toolbox you run yourself. Merge, split, rotate, compress, convert, sign, redact and OCR your PDFs in the browser, and the files never leave your server.

Features

  • Over 50 tools: merge, split, reorder, rotate, compress, watermark
  • Convert to and from PDF: Office files, images, HTML, Markdown
  • OCR for scanned pages, in many languages
  • Sign, add passwords, redact and change permissions
  • Edit text in a PDF and compare two files
  • Chain tools into pipelines, and a REST API for scripts
  • Optional login with users, teams and OIDC

How to use

  1. Open http://[ZIMAOS-IP-ADDRESS]:6736 in your browser.
  2. Press Add Files and pick your PDFs.
  3. Pick a tool on the right, then download the result.

Before you install

There is no login by default; keep port 6736 on your home network. To need a login, set SECURITY_ENABLELOGIN to true: the first login is admin with the password stirling, and you must pick a new password straight away. The first start takes a minute or two, and the app likes 1 to 2 GB of memory for big files and Office conversions. The language, upload limit and other settings are in the Variables tab; add them in the app settings.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.
PUID$PUIDThe user Stirling-PDF runs as. ZimaOS fills this in.
PGID$PGIDThe group Stirling-PDF runs as. ZimaOS fills this in.
SECURITY_ENABLELOGINfalseSet to true to need a login. The first login is admin with the password stirling, and you must pick a new password right away. Leave it false for no login on your home network.

Server

VariableDefault valueDescription
SYSTEM_DEFAULTLOCALE—The language for new users, like en-GB, de-DE or fr-FR. Leave it out to follow each browser.
SYSTEM_FRONTENDURL—The address people open Stirling-PDF at, like http://192.168.1.20:6736. Needed for share links and the phone QR code upload.
UI_APPNAMENAVBAR—The name shown in the browser tab. Leave it out for Stirling PDF.
JAVA_CUSTOM_OPTS—Extra Java options, like -Xmx2g to give it at most 2 GB of memory.

Login

VariableDefault valueDescription
SECURITY_INITIALLOGIN_USERNAME—With login on, the first admin's name instead of admin. Only used on the very first start.
SECURITY_INITIALLOGIN_PASSWORD—With login on, the first admin's password instead of stirling. Only used on the very first start.

Features

VariableDefault valueDescription
SYSTEM_ENABLEANALYTICS—Set to false to turn off sending usage statistics to Stirling. Left out, the admin is asked on first launch.
SYSTEM_GOOGLEVISIBILITYfalseSet to true to let search engines list your Stirling-PDF.
docker-compose.yml
name: stirling-pdf

services:
  stirling-pdf:
    image: stirlingtools/stirling-pdf:3.3.0
    container_name: stirling-pdf
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - PUID=$PUID
      - PGID=$PGID
      - SECURITY_ENABLELOGIN=false
    ports:
      - target: 8080
        published: "6736"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/configs
        target: /configs
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/tessdata
        target: /usr/share/tessdata
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/logs
        target: /logs
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://127.0.0.1:8080/api/v1/info/status"]
      interval: 30s
      timeout: 15s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 4096M
        reservations:
          cpus: "0.00"
          memory: 512M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/stirling-pdf/icon.png
    x-casaos:
      id: com.icestore.stirling-pdf
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: PUID
          description:
            en_US: The user Stirling-PDF runs as. ZimaOS fills this in.
        - container: PGID
          description:
            en_US: The group Stirling-PDF runs as. ZimaOS fills this in.
        - container: SECURITY_ENABLELOGIN
          description:
            en_US: >-
              Set to true to need a login. The first login is admin with the
              password stirling, and you must pick a new password right away.
              Leave it false for no login on your home network.
      ports:
        - container: "8080"
          description:
            en_US: Stirling-PDF web page and API, published on host as 6736
      volumes:
        - container: /configs
          description:
            en_US: >-
              Settings (settings.yml) and, with login on, the user database.
              Back this folder up.
        - container: /usr/share/tessdata
          description:
            en_US: OCR language files. Add more languages here.
        - container: /logs
          description:
            en_US: Stirling-PDF's log files.

x-casaos:
  id: com.icestore.stirling-pdf
  architectures:
    - amd64
    - arm64
  main: stirling-pdf
  author: HSinghHira
  category: Productivity
  developer: Stirling-Tools
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/stirling-pdf/icon.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/stirling-pdf/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/stirling-pdf/screenshot-2.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/stirling-pdf/screenshot-1.png
  title:
    en_US: Stirling-PDF
  tagline:
    en_US: Edit, merge, split, convert, sign and OCR PDF files in your browser.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/stirling-pdf/](https://icestore.hsinghhira.me/app/stirling-pdf/) for full details


      Stirling-PDF is a PDF toolbox you run yourself. Merge, split, rotate,
      compress, convert, sign, redact and OCR your PDFs in the browser, and
      the files never leave your server.


      **Features**


      - Over 50 tools: merge, split, reorder, rotate, compress, watermark

      - Convert to and from PDF: Office files, images, HTML, Markdown

      - OCR for scanned pages, in many languages

      - Sign, add passwords, redact and change permissions

      - Edit text in a PDF and compare two files

      - Chain tools into pipelines, and a REST API for scripts

      - Optional login with users, teams and OIDC


      **How to use?**


      1. Open http://[ZIMAOS-IP-ADDRESS]:6736 in your browser.


      2. Press Add Files and pick your PDFs.


      3. Pick a tool on the right, then download the result.
  tips:
    before_install:
      en_US: >-
        1. Leave SECURITY_ENABLELOGIN as false for no login, or set it to
           true to need one.


        2. Start the installation. The first start takes a minute or two.


        3. Open http://[ZIMAOS-IP-ADDRESS]:6736 in your browser, like
           http://192.168.1.20:6736 on your laptop.


        4. With login on, sign in as admin with the password stirling, then
           pick a new password.


        5. More settings, like the language and the file size limit, are
           listed on the Stirling-PDF page at
           https://icestore.hsinghhira.me/app/stirling-pdf/ (Variables tab).
           You can add them now or later in the app settings.
  index: /
  port_map: "6736"
  scheme: http
  is_uncontrolled: false
  version: "3.3.0"
  update_at: "2026-11-16"
  release_notes:
    en_US: |-
      - First IceStore version: stirlingtools/stirling-pdf 3.3.0
      - Web page on port 6736, login off by default
  repo: "https://github.com/Stirling-Tools/Stirling-PDF"
  support: "https://github.com/Stirling-Tools/Stirling-PDF/issues"
  docs: "https://docs.stirlingpdf.com"

Install Stirling-PDF

Something not working with Stirling-PDF?

Report it so it gets fixed, or ask for an app that is not here yet.

More Productivity apps

See all