Muddog installieren und aktualisieren

Systemvoraussetzungen

Prüfen Sie auf der Downloadseite das Betriebssystem und die Version, bevor Sie die Installationsdatei herunterladen.

Betriebssystem	Paket und Anleitung
Linux x86_64	.deb- und .rpm-Pakete. Eine Desktop-Umgebung mit systemd ist erforderlich.
Windows 10/11 x64	.msi-Installationsdatei. Das Windows-Paket unterstützt derzeit nur x64.
macOS 13 Ventura oder neuer	.dmg-Installationsdatei. Das Universal-Paket unterstützt Intel und Apple Silicon. Zum Steuern der App ist ein macOS-Administratorkonto erforderlich.

Unter Linux installiert die Paketverwaltung auch die für die App benötigten Bibliotheken und Abhängigkeiten. Für VPN pro App unter Linux sind zusätzlich eine systemd-Benutzersitzung und cgroup v2 erforderlich. nftables gehört zu den Paketabhängigkeiten. Auch Windows unterstützt VPN pro App. macOS unterstützt VPN für das gesamte Internet sowie für bestimmte IP-Adressen und Bereiche.

Diese Anleitung gilt für Version 2.x. Wenn auf der Downloadseite noch keine 2.x-Datei für Ihr Betriebssystem angezeigt wird, prüfen Sie zuerst, ob sie bereits veröffentlicht wurde. Für die .exe-Datei der Windows-Version 1.0.7 gilt die Anleitung zur älteren Version.

Mit dem Dienst startet auch die Freigabe

Unter Linux und Windows startet die Internetfreigabe nach Abschluss der Installation automatisch, unter macOS nach dem ersten Start und der Genehmigung des Hintergrunddienstes. Danach wird der Dienst auch beim Systemstart ausgeführt. Andere Nutzer können Ihren Internetanschluss verwenden, ohne dass Sie das App-Fenster öffnen. Lesen Sie vor der Installation Internetfreigabe verwalten.

Unter Linux installieren

Die folgenden Befehle verwenden beispielhaft Dateinamen der Version 2.0.0. Wechseln Sie im Terminal in das Verzeichnis mit der heruntergeladenen Datei und ersetzen Sie den Dateinamen durch den tatsächlichen Namen Ihres Pakets. Für die Installation sind Administratorrechte erforderlich.

Debian / Ubuntu

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora

sudo dnf install ./muddog-2.0.0-1.x86_64.rpm

Erster Start nach der Installation

1. Melden Sie sich nach der Installation vom Desktop ab und wieder an.
2. Starten Sie Muddog über das Anwendungsmenü.
3. Prüfen Sie, ob unter Verbindung der VPN-Status und der Status von Meine Internetfreigabe angezeigt werden.
4. Wählen Sie ein Land und stellen Sie die Verbindung wie unter VPN verbinden beschrieben her.

Bei einer Installation mit sudo aus einem normalen Benutzerkonto wird dieser Benutzer zur Gruppe muddog hinzugefügt. Erst nach einer erneuten Anmeldung stehen diese Berechtigungen der App zur Verfügung. Starten Sie die App als normaler Benutzer. Für die VPN-Nutzung geben Sie weder Mudfish-ID noch Passwort ein.

Wenn ein Administrator die Installation über ein anderes Konto durchgeführt hat oder mehrere Benutzer die App steuern sollen, lesen Sie Zugriffsrechte auf den Dienst prüfen.

Unter Windows installieren

1. Falls Muddog mit dem früheren .exe-Installationsprogramm installiert wurde, entfernen Sie es zuerst unter Einstellungen → Apps in Windows. Wenn Sie zum Entfernen der vorhandenen Installation aufgefordert werden, schließen Sie die Deinstallation ab und starten Sie anschließend die MSI-Installation erneut.
2. Öffnen Sie die heruntergeladene .msi-Datei und bestätigen Sie die Anforderung von Administratorrechten.
3. Folgen Sie den Installationsanweisungen. Fehlt die WebView2 Runtime, lädt der Installationsassistent sie aus dem Internet herunter. Dafür ist eine Internetverbindung erforderlich.
4. Starten Sie muddog über das Startmenü oder den Desktop mit normalen Benutzerrechten.
5. Prüfen Sie unter Verbindung den Dienststatus und fahren Sie mit VPN verbinden fort.

Das Standardinstallationsverzeichnis ist %ProgramFiles%\muddog. Das Installationsprogramm registriert den Dienst muddog-engine, startet ihn automatisch und fügt die für die Engine erforderlichen Firewallregeln für eingehenden UDP-Verkehr hinzu. Die Komponenten für VPN und VPN pro App sind im Paket enthalten. Sie müssen die App nicht bei jeder Nutzung als Administrator starten.

Unter macOS installieren

1. Öffnen Sie die heruntergeladene .dmg-Datei.
2. Kopieren Sie Muddog.app in den Ordner Programme (/Applications). Bei einem direkten Start aus dem DMG kann der Hintergrunddienst nicht registriert werden.
3. Starten Sie die kopierte App Muddog, während Sie mit einem macOS-Administratorkonto angemeldet sind.
4. Erlauben Sie Muddog unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen die Ausführung im Hintergrund. Die Bezeichnung kann je nach macOS-Version abweichen.
5. Sobald sich die App wieder mit dem Dienst verbunden hat, fahren Sie mit VPN verbinden fort.

Um die Genehmigungseinstellungen erneut zu öffnen, wählen Sie in der macOS-Menüleiste Service → Background Service Settings…. Wenn der Dienst registriert werden muss, wählen Sie Service → Enable Background Service. Diese Menüpunkte werden auf Englisch angezeigt. Starten Sie die App selbst ohne sudo.

Aktualisieren

Wenn Sie das VPN nutzen, klicken Sie auf Verbindung trennen. Laden Sie dann die neue Installationsdatei für Ihr Betriebssystem von der Downloadseite herunter.

• Linux: Schließen Sie die App und installieren Sie die neue .deb- oder .rpm-Datei mit dem oben gezeigten Befehl und dem neuen Dateinamen.
• Windows: Schließen Sie die App und öffnen Sie die neue .msi-Datei. Die vorhandene MSI-Installation wird beim Update ersetzt.
• macOS: Entfernen Sie zuerst mit Service → Remove Background Service and Quit den Dienst und beenden Sie die App. Ersetzen Sie die App in /Applications durch Muddog.app aus dem neuen DMG. Starten Sie sie erneut und erteilen Sie die erforderliche Genehmigung für den Dienst.

Beim Update werden laufende VPN- und Freigabeverbindungen unterbrochen. Öffnen Sie danach die App erneut und prüfen Sie den Verbindungs- und Freigabestatus. Wenn ein Fehler auf unterschiedliche Versionen von App und Dienst hinweist, lesen Sie die Fehlerbehebung.

Beim Wechsel von der älteren Linux-Version 1.0.7 schließen Sie zunächst die alte App und installieren dann das neue Paket. Ist der alte Dienst muddog_srv.service registriert, wird er bei der Installation gestoppt und sein automatischer Start deaktiviert. Starten Sie anschließend Muddog im Anwendungsmenü.

Deinstallieren

Linux

Unter Debian / Ubuntu verwenden Sie folgenden Befehl:

sudo apt remove muddog

Unter Fedora verwenden Sie folgenden Befehl:

sudo dnf remove muddog

Beim Entfernen des Pakets werden Dienst und VPN beendet und die von Muddog hinzugefügten Netzwerkrouten entfernt. Wenn Sie unter Debian / Ubuntu auch das dedizierte Dienstkonto und die Gruppe entfernen möchten, können Sie statt der normalen Deinstallation sudo apt purge muddog verwenden.

Windows

Wählen Sie unter Einstellungen → Apps in Windows muddog aus und deinstallieren Sie es. Dabei werden Dienst und VPN beendet und die VPN-Routen entfernt. Anschließend werden der Dienst und die bei der Installation hinzugefügten Firewallregeln gelöscht. Benutzereinstellungen sowie Verbindungs- und Weiterleitungsprotokolle bleiben erhalten.

macOS

1. Wählen Sie in der App Service → Remove Background Service and Quit.
2. Sobald der Dienst entfernt und die App beendet ist, verschieben Sie Muddog.app aus /Applications in den Papierkorb.

Wenn Sie zuerst nur die App-Datei löschen, kann sich das Entfernen des Hintergrundeintrags verzögern. Benutzereinstellungen sowie Verbindungs- und Weiterleitungsprotokolle bleiben erhalten.

Verbleibende Protokolle und Beenden der Freigabe

Das Entfernen des Pakets löscht nicht die Verbindungs- und Weiterleitungsprotokolle. Speicherort und Aufbewahrung der verbleibenden lokalen Protokolle sind unter Verbindungs- und Weiterleitungsprotokolle beschrieben. Wenn Sie das Programm behalten und nur die Freigabe beenden möchten, können Sie den Dienst stoppen. Solange der Dienst gestoppt ist, können Sie jedoch auch Ihr eigenes VPN nicht nutzen.