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
- File: pdfmy-Scan-1.23.0.exe (signed by Mentor GmbH) · SHA-256
1b4d33cf883e540d9e7c860d6660d67a11cd4fbe426677643b623c6fbda32bf6 - Install (as SYSTEM or administrator):
pdfmy-Scan-1.23.0.exe --install-all-users --quiet– installs pdfmy Scan in the folderC:\Program Files\pdfmy Scanand sets it to start at every sign-in, adding it to the Start menu and to “Installed apps”. Exit code 0 = success. - Remove:
"C:\Program Files\pdfmy Scan\pdfmy-Scan.exe" --uninstall-all-users --quiet– user settings are kept. - Detection (Intune, SCCM/MECM): registry key
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\pdfmy-scan-machine, valueDisplayVersion= 1.23.0. - Updates: An installation for all users does not update itself and shows no update notices – IT deploys new versions with the same command. The current version is available in machine-readable form in download/version.json (fields
pdfmyScanandsha256). - If a user had already installed pdfmy Scan themselves, their copy steps aside: the all-users version starts.
- Right-click “Open in PDFMy” and “Send to → PDFMy” (from 1.18.0): for PDF, Word, Excel, PowerPoint, OpenDocument, images, emails (.eml, .msg), and text – per user under
HKCU\Software\Classes\SystemFileAssociations\<Endung>\shell\PDFMy.Open; the default programs stay unchanged. To remove:pdfmy-Scan.exe --unregister.
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:
DisableUpdates– pdfmy Scan does not update itself and offers no updates (also for per-user installations).- Without a policy, every user can turn off automatic installation in the pdfmy Scan menu (“Updates automatisch installieren”, from 1.18.1); new versions are then only announced.
DisablePrinter– do not offer the “PDFMy” printer.
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:
- Outlook: “PDFMy” button when reading and composing. Open, edit and sign PDF attachments; when composing, attach the edited PDF again or scan a new PDF and attach it.
- Outlook for iPhone and Android: “PDFMy” button when reading an email; attachments open in PDFMy directly in the add-in (Microsoft does not allow add-in buttons on mobile devices while composing). Requirement: mailbox in Microsoft 365 (Exchange Online).
- Word, Excel, PowerPoint: “Open in PDFMy” button on the “Home” tab. Word and PowerPoint pass the document on as a PDF, Excel as a workbook (PDFMy converts it).
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.
- Manifest for Outlook: pdfmy-outlook.xml
- Manifest for Word, Excel and PowerPoint: pdfmy-office.xml
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).
- 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 - 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 - Den Ordner per HTTPS als Website oder Unterordner ausliefern (für den Offline-Betrieb nötig). Für IIS liegt eine
web.configmit den Dateitypen bei. nginx:location /pdfmy/ { alias /var/www/pdfmy/; } location ~ /pdfmy/(sw\.js|pruefsummen\.json)$ { add_header Cache-Control "no-cache"; } - Eigene Links in der Fußzeile (Impressum, Datenschutz, Hilfe des Hauses):
eigene-links.jsonnach dem Mustereigene-links.beispiel.jsonin den Ordner legen. Eigene Dateien bleiben bei Updates erhalten. - 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-vorlagedaneben. 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
- Linux (for all users, e.g. via Ansible or Puppet):
apt install ./pdfmy-scan-linux.deb·dnf install ./pdfmy-scan-linux.rpm·zypper install ./pdfmy-scan-linux.rpm·pacman -U ./pdfmy-scan-linux.pkg.tar.gz - Mac (per user, e.g. as a device management script in the user context):
curl -fsSL https://pdfmy.de/download/pdfmy-scan-mac.sh | bash
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.