Ga naar hoofdinhoud

Muddog installeren en bijwerken

Vereisten​

Controleer besturingssysteem en versie op de downloadpagina.

SysteemPakket en gebruik
Linux x86_64.deb- en .rpm-pakketten. Vereist een desktopomgeving met systemd.
Windows 10/11 x64.msi-installatiebestand. Het huidige Windows-pakket ondersteunt alleen x64.
macOS 13 Ventura of nieuwer.dmg-installatiebestand. Het Universal-pakket ondersteunt Intel en Apple Silicon. Een macOS-beheerdersaccount is nodig om de app te bedienen.

Het Linux-pakketbeheer installeert de benodigde bibliotheken en afhankelijkheden. Voor VPN per app zijn ook een systemd-gebruikerssessie en cgroup v2 nodig; nftables zit bij de pakketafhankelijkheden. Windows ondersteunt ook VPN per app. macOS ondersteunt VPN voor heel internet of op basis van IP-adressen en bereiken.

Deze handleiding geldt voor 2.x. Staat er voor jouw systeem nog geen 2.x-bestand op de downloadpagina, controleer dan eerst de beschikbaarheid. Voor het Windows-.exe-bestand van 1.0.7 geldt de oude handleiding.

Delen begint zodra de service start

Op Linux en Windows start internetdeling na installatie; op macOS na de eerste start en goedkeuring van de achtergrondservice. Daarna start de service ook bij het opstarten van de computer. Anderen kunnen je verbinding dus gebruiken zonder dat je het appvenster opent. Lees vooraf Internetdeling beheren.

Installeren op Linux​

Onderstaande voorbeelden gebruiken bestandsnamen van 2.0.0. Open in de terminal de downloadmap en vervang de bestandsnaam door die van je werkelijke pakket. Installatie vereist beheerdersrechten.

Debian / Ubuntu​

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora​

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

Eerste start na installatie​

  1. Log uit en opnieuw in op je desktop.
  2. Start Muddog via het appmenu.
  3. Controleer op het scherm Verbinding of de VPN-status en Mijn internetdeling zichtbaar zijn.
  4. Kies een land en verbind volgens VPN verbinden.

Bij installatie met sudo vanuit een gewone gebruikersaccount wordt die gebruiker aan de groep muddog toegevoegd. Opnieuw inloggen is nodig om deze rechten in de app toe te passen. Start de app als gewone gebruiker; je hebt geen Mudfish-ID of wachtwoord nodig.

Heeft een beheerder met een ander account geïnstalleerd of moeten meerdere gebruikers de app bedienen, zie dan Servicetoegang controleren.

Installeren op Windows​

  1. Verwijder een eerdere Muddog-installatie via het .exe-installatieprogramma eerst via Instellingen → Apps. Als de installer om verwijdering vraagt, doe dat dan en start daarna de MSI opnieuw.
  2. Start het gedownloade .msi-bestand en keur de aanvraag voor beheerdersrechten goed.
  3. Volg de instructies. Ontbreekt WebView2 Runtime, dan downloadt de installer dit van internet; daarvoor is een internetverbinding nodig.
  4. Start muddog via het startmenu of bureaublad als gewone gebruiker.
  5. Controleer de servicestatus op Verbinding en volg VPN verbinden.

De standaardinstallatiemap is %ProgramFiles%\muddog. De installer registreert en start muddog-engine en voegt de benodigde firewallregel voor inkomende UDP toe. Onderdelen voor VPN en VPN per app zijn inbegrepen. Je hoeft de app niet telkens als beheerder te starten.

Installeren op macOS​

  1. Open het gedownloade .dmg-bestand.
  2. Kopieer Muddog.app naar Apps (/Applications). Rechtstreeks vanuit de DMG uitvoeren kan de achtergrondservice niet registreren.
  3. Start de gekopieerde Muddog vanuit een macOS-beheerdersaccount.
  4. Sta achtergrondactiviteit voor Muddog toe via Systeeminstellingen → Algemeen → Inloggen en extensies. De benaming kan per macOS-versie verschillen.
  5. Volg VPN verbinden zodra de app weer met de service verbonden is.

Open het toestemmingsscherm opnieuw via Service → Background Service Settings… in de menubalk. Kies zo nodig Service → Enable Background Service om de service te registreren. Deze menu’s worden in het Engels getoond. Start de app zelf zonder sudo.

Bijwerken​

Verbreek een actieve VPN en download het nieuwe installatiebestand voor je systeem.

  • Linux: sluit de app en gebruik de installatieopdracht met de nieuwe .deb- of .rpm-bestandsnaam.
  • Windows: sluit de app en start de nieuwe .msi. Een bestaande MSI-installatie wordt vervangen.
  • macOS: kies eerst Service → Remove Background Service and Quit. Vervang daarna de app in /Applications door Muddog.app uit de nieuwe DMG, start opnieuw en voltooi de benodigde servicegoedkeuring.

Tijdens de update worden VPN- en gedeelde verbindingen verbroken. Open daarna de app en controleer beide statussen. Verschillen app- en serviceversie, zie Problemen oplossen.

Bij overstappen van Linux-versie 1.0.7 sluit je de oude app en installeer je het nieuwe pakket. De installer stopt een eventueel bestaande muddog_srv.service en schakelt de automatische start daarvan uit. Gebruik voortaan Muddog in het appmenu.

Verwijderen​

Linux​

Op Debian / Ubuntu:

sudo apt remove muddog

Op Fedora:

sudo dnf remove muddog

Verwijderen stopt de service en VPN en ruimt toegevoegde netwerkroutes op. Gebruik op Debian / Ubuntu eventueel sudo apt purge muddog in plaats van gewone verwijdering om ook het serviceaccount en de groep te verwijderen.

Windows​

Verwijder muddog via Instellingen → Apps. Dit stopt service en VPN, ruimt VPN-routes op en verwijdert de service en de tijdens installatie toegevoegde firewallregels. Gebruikersinstellingen en verbindings- en doorstuurlogboeken blijven bewaard.

macOS​

  1. Kies Service → Remove Background Service and Quit.
  2. Wacht tot de service is verwijderd en de app is gesloten. Verplaats daarna Muddog.app uit /Applications naar de prullenmand.

Als je alleen het appbestand eerst verwijdert, kan het opruimen van achtergrondonderdelen vertraging oplopen. Gebruikersinstellingen en logboeken blijven bewaard.

Resterende logboeken en stoppen met delen​

Pakketverwijdering en het verwijderen van logboeken zijn afzonderlijke handelingen. Zie Verbindings- en doorstuurlogboeken voor locatie en bewaring. Je kunt de app behouden en delen stoppen door de service te stoppen, maar je eigen VPN is dan ook niet beschikbaar.