Overview
Installers, stable URLs and where to start when deploying the desktop app centrally
These pages are for IT administrators who deploy the DeutschlandGPT desktop app centrally, for example through Microsoft Intune, a group policy, Jamf Pro or another MDM. If your users install the app themselves, there is nothing to do here: the app keeps itself up to date.
Which installer should you use?
| File | Installs to | Admin rights | Automatic updates | Intended for |
|---|---|---|---|---|
.msi (Windows) | C:\Program Files | yes | no | Central deployment, Intune, GPO |
-setup.exe (Windows) | %LOCALAPPDATA% | no | yes | Self-service installation |
.dmg (macOS) | /Applications | depends | yes, if writable | Self-service installation, MDM |
.deb (Linux) | /usr/bin | yes | no | Central deployment through apt |
.rpm (Linux) | /usr/bin | yes | no | Central deployment through dnf |
.AppImage (Linux) | anywhere you choose | no | yes, if writable | Self-service installation |
The detail pages take it from there: Windows for MSI, EXE and winget, macOS for the DMG, Installomator and Jamf Pro, Linux for the DEB, RPM and AppImage. How automatic updates behave and how to control them is on Controlling updates.
Stable URLs
Every URL below permanently resolves to the newest published build, so a script, a package or an Installomator label never has to be touched for a release.
| Purpose | URL |
|---|---|
| Windows MSI | https://www.deutschlandgpt.de/api/desktop/download/windows-msi |
| Windows EXE | https://www.deutschlandgpt.de/api/desktop/download/windows |
| macOS DMG | https://www.deutschlandgpt.de/api/desktop/download/darwin |
| Linux DEB | https://www.deutschlandgpt.de/api/desktop/download/linux-deb |
| Linux RPM | https://www.deutschlandgpt.de/api/desktop/download/linux-rpm |
| Linux AppImage | https://www.deutschlandgpt.de/api/desktop/download/linux-appimage |
| Version number | https://www.deutschlandgpt.de/api/desktop/version/<target> |
| winget source | https://www.deutschlandgpt.de/api/desktop/winget |
<target> is windows, windows-msi, darwin, linux-appimage, linux-deb or linux-rpm.
The download URLs answer with a redirect to the file. Add ?json=1 and they return the version number and file URL as JSON instead, which is handy for scripts that upload new versions to Intune automatically.
The version endpoint answers with plain text, just the version number and a newline:
curl -fsL https://www.deutschlandgpt.de/api/desktop/version/darwin
# 1.4.0
That lets a script compare versions without a JSON parser. Our Installomator label uses exactly this.
While nothing is published for a target, both endpoints answer with 404, and with 503 during
an outage. A script should catch that case and skip the run rather than treating the response as a
version number.
Signatures
Both Windows installers are Authenticode-signed by Titanom Technologies GmbH. Verify with signtool verify /pa <file> or through Properties, Digital Signatures.
The macOS app is signed with a Developer ID certificate and notarised by Apple. The team ID is XT228V86UU, the bundle identifier de.deutschlandgpt.desktop. How to verify that on a device is on the macOS page.
Linux has no comparable operating-system mechanism. Provenance for the DEB, RPM and AppImage comes from the TLS download from www.deutschlandgpt.de.
Network
Firewall and proxy requirements are the same as for the running app. Updates use their own addresses, which have to be allowed separately. The full list is on Network requirements.