PDFMypowered by Mentor Group
← back to PDFMy

Deploying PDFMy in companies

PDFMy itself is a web app – nothing needs to be installed on the computers. For scanners, “PDF by double-click”, the “PDFMy” printer and the Office integration, IT deploys the small program pdfmy Scan: silently, for all users, without prompts.

Windows: pdfmy Scan for all users

Intune: create a Win32 app from the .exe, install and uninstall commands as above, install behavior “System”, detection rule as above. Group Policy: computer startup script with the install command. Terminal server: supported – each user gets their own port, other users’ documents cannot be accessed; pdfmy Scan does not offer the “PDFMy” printer there.

Policies

Under HKLM\SOFTWARE\Policies\Mentor GmbH\PDFMy (or under HKCU for individual users), type DWORD, 1 = on:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Mentor GmbH\PDFMy]
"DisableUpdates"=dword:00000001

PDFMy as an app for all users (Chrome and Edge)

With the browser policy WebAppInstallForceList PDFMy appears as an app in the Start menu and on the desktop:

[{"url": "https://pdfmy.de/", "default_launch_container": "window", "create_desktop_shortcut": true}]

Microsoft 365: Outlook, Word, Excel, PowerPoint

With the PDFMy add-in, users open documents and attachments in PDFMy directly from Office – on their own device, without uploading:

Deploy to everyone: Microsoft 365 admin center → Settings → Integrated apps → Upload custom apps → “Office Add-in” → upload the manifest file, choose users or groups. The buttons appear for all selected users after a few hours.

Individually: In Outlook Get Add-ins → My add-ins → Add a custom add-in → Add from file; in Word, Excel and PowerPoint on the web Add-ins → My Add-ins → Upload My Add-in.

Privacy: The add-in only reads the open document or the selected attachment and passes it to PDFMy on the same device. The add-in pages load Microsoft’s Office library (required by Microsoft for Office add-ins), otherwise only files from pdfmy.de. There is no account, no server and no telemetry.

Microsoft Teams

PDFMy as a personal app in Teams: pdfmy-teams.zip. Teams admin center → Teams apps → Manage apps → Upload, then pin it with a setup policy. Individually (if allowed): Teams → Apps → Manage your apps → Upload an app.

Thunderbird

Extension pdfmy-thunderbird-1.0.1.xpi (Thunderbird 115 or later): open attachments in PDFMy with the “PDFMy” button or by right-clicking, and attach edited or new PDFs while composing. Individually: Tools → Add-ons and Themes → gear icon → Install Add-on From File. For everyone: policy ExtensionSettings – run it with "pdfmy@mentor-group.de": {"installation_mode": "force_installed", "install_url": "https://pdfmy.de/download/pdfmy-thunderbird-1.0.1.xpi"}.

LibreOffice and Collabora Office

Extension pdfmy-libreoffice-1.0.0.oxt (LibreOffice 7.0 or later, Windows, Mac, Linux): File → Open in PDFMy and an icon in the toolbar. Writer, Calc, Impress and Draw save the document as a PDF to a working folder on the computer, and pdfmy Scan opens it in PDFMy – no upload. Without pdfmy Scan, the extension shows the folder and opens pdfmy.de. Individually: double-click the file or Tools → Extension Manager → Add. For all users: unopkg add --shared pdfmy-libreoffice-1.0.0.oxt (as administrator).

Nextcloud

App pdfmy-nextcloud-1.0.1.zip (Nextcloud 28 to 35): in “Files”, PDFs, images and Office files offer Open in PDFMy. PDFMy opens in a new tab and asks once whether the file may come from your Nextcloud; Save to Nextcloud stores a PDF as a new version of the same file (the old one remains in the versions), and other formats as a PDF alongside it. The file only travels between the browser and PDFMy. Setup: extract the ZIP into the custom_apps (or apps) folder of your Nextcloud, then run occ app:enable pdfmy or enable it under Apps → Disabled apps .

ONLYOFFICE Docs

Plugin pdfmy-onlyoffice-1.0.1.plugin (ONLYOFFICE Docs 7.4 or later, e.g. in Nextcloud, ownCloud, Seafile or DocSpace): Plugins → PDFMy tab → Open in PDFMy. ONLYOFFICE creates the PDF on your own ONLYOFFICE server, and PDFMy takes it over in the browser. Setup: Plugins → Plugin Manager → Install plugin and choose the file, or, for all users, place it unpacked in the server’s plugin folder. In the ONLYOFFICE desktop apps, ONLYOFFICE does not pass a PDF to plugins – there, use File → Print with the “PDFMy” printer.

PDFMy auf dem eigenen Server

PDFMy besteht nur aus statischen Dateien. Sie können die App im eigenen Netz ausliefern, z. B. unter https://pdf.intern.example/ – ohne Datenbank, ohne Server-Code, ohne Verbindung der Nutzer ins Internet. Dokumente bleiben wie bei pdfmy.de im Browser und gehen auch nicht an Ihren Server. Das Paket enthält nur die App (keine Website, kein Impressum und keine Zählseiten von pdfmy.de).

  1. Installieren und automatisch aktualisieren – Linux (nginx, Apache, Docker-Host):
    curl -fsSLO https://pdfmy.de/selfhost/pdfmy-selfhost.sh && sudo bash pdfmy-selfhost.sh installieren /var/www/pdfmy
  2. Windows Server mit IIS (PowerShell als Administrator):
    Invoke-WebRequest https://pdfmy.de/selfhost/pdfmy-selfhost.ps1 -OutFile pdfmy-selfhost.ps1; .\pdfmy-selfhost.ps1 installieren C:\inetpub\pdfmy
  3. Den Ordner per HTTPS als Website oder Unterordner ausliefern (für den Offline-Betrieb nötig). Für IIS liegt eine web.config mit den Dateitypen bei. nginx: location /pdfmy/ { alias /var/www/pdfmy/; } location ~ /pdfmy/(sw\.js|pruefsummen\.json)$ { add_header Cache-Control "no-cache"; }
  4. Eigene Links in der Fußzeile (Impressum, Datenschutz, Hilfe des Hauses): eigene-links.json nach dem Muster eigene-links.beispiel.json in den Ordner legen. Eigene Dateien bleiben bei Updates erhalten.
  5. Sicherheits-Kopfzeilen wie auf pdfmy.de (Content-Security-Policy, nosniff, Referrer- und Permissions-Policy, Schutz vor Einbetten in fremde Seiten) liegen bei: .htaccess (Apache), web.config (IIS), nginx-pdfmy.conf (Vorlage). Passen Sie eine davon an, behält das Update Ihre Fassung und legt die neue von PDFMy als ….pdfmy-vorlage daneben. HSTS bitte auf Serverebene setzen.

Updates: Der Server prüft täglich zwischen 3 und 6 Uhr (zufällige Minute) selbst, ob es eine neue Fassung gibt. Installiert wird nur eine von der Mentor GmbH signierte Fassung (RSA-3072, SHA-256) mit passender Prüfsumme und höherer Nummer – nie eine ältere. Der Wechsel geschieht ohne Ausfallzeit; zurueck holt die vorige Fassung zurück, pruefen zeigt nur an, ob es etwas Neues gibt, automatik-aus schaltet die tägliche Prüfung ab. Zwei Kanäle: stabil (Standard, erst nach 7 Tagen ohne Rücknahme auf pdfmy.de, derzeit v292) und aktuell (--kanal=aktuell or -Kanal aktuell, jede Fassung sofort, derzeit v326). Eigener Spiegel im Intranet: PDFMY_QUELLE or -Quelle. Die Abfrage überträgt nur die üblichen Verbindungsdaten Ihres Servers, keine Kennung und keine Nutzungsdaten. Regeln für Fassungen, Sicherheitsupdates und Fristen: Update-Strategie.

Prüfen: pdfmy-selfhost.sh SHA-256 3fc23275376b9b436fcd104434ea4e189a92ee2adfc65a19aeb944a14d534839 · pdfmy-selfhost.ps1 SHA-256 48c56cd8622a43c69d3334a33f63f4a473b4e9bdb7bc09b85f1a1dfb62ef0ed5 · Signaturen: pdfmy-selfhost-sh.sig, pdfmy-selfhost-ps1.sig, öffentlicher Schlüssel: pdfmy-update-schluessel.pem (openssl dgst -sha256 -verify pdfmy-update-schluessel.pem -signature <(base64 -d pdfmy-selfhost-sh.sig) pdfmy-selfhost.sh). Paket von Hand: pdfmy-selfhost-v326.tar.gz (106 MB, SHA-256 94894c9bd14ae377301d8c2756cfd7f15a168ec39b0b5cb9dcf01e8beea0a122).

Lizenzbedingungen beachten: Für den Betrieb auf einem eigenen Server gelten die Lizenzbedingungen auf GitHub: github.com/haus-it/pdfmy – LICENSE (PolyForm Noncommercial License 1.0.0) mit den Hinweisen in NOTICE. Bitte prüfen Sie vor der Installation, ob Ihre Nutzung davon gedeckt ist. Für eine andere Nutzung, etwa im Unternehmen, sprechen Sie bitte die Mentor GmbH an: wumertens@mentor-group.de.

Linux and Mac

Privacy and security

Documents never leave the computer: PDFMy works in the browser, pdfmy Scan can only be reached from the computer itself (127.0.0.1) and only answers requests from the signed-in user. There is no telemetry and no user account. pdfmy Scan verifies updates by SHA-256 and the signature of Mentor GmbH. Questions about deployment: wumertens@mentor-group.de

For IT security, data protection and procurement in companies and government agencies: Security and compliance · ADMX templates · SBOM

Found a bug or have an idea? Report a bug – by email from your mail program, without documents.