...

AKR Updater

1.7.3

...

💻 Installatiecommando
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

Deze praktische gids legt het gebruik van de software stap voor stap uit, van het ontdekken van de webinterface tot het instellen van je eerste geplande taken. Je leert ook hoe je je Discord-account kunt koppelen om herstarts op afstand te beheren.

Voordat je de toepassing gaat uitrollen, ontdek je hier de stappen om je host snel en volgens de regels van de kunst te configureren. De gehele procedure is gebaseerd op één enkele shell-opdracht die in je Linux-terminal wordt uitgevoerd.

Installatie

1

Voorbereiding van de Linux-omgeving

Start een Linux-systeem of maak een schone dedicated LXC-container aan om de dienst te hosten. Zorg ervoor dat je terminaltoegang hebt met sudo-beheerdersrechten en een actieve netwerkverbinding om de benodigde bestanden te downloaden.

2

Uitvoering van het installatiecommando

Open je terminal en plak exact het volgende commando: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Bevestig de uitvoering om het officiële geautomatiseerde installatiescript te starten.

3

Wachten op de automatische configuratie

Laat het installatieproces de bestanden uitrollen en de achtergronddiensten configureren. Het script draait zelfstandig binnen enkele seconden om de componenten voor te bereiden die nodig zijn voor de werking van het systeem.

4

Controle van de netwerkpoorten

Controleer of TCP-poort 8080 toegankelijk is vanaf je lokale netwerk of sta deze toe in je applicatie-firewallregels. Deze poort is essentieel om te communiceren met de grafische beheerdersinterface die door de software wordt gehost.

5

Toegang tot het webbeheerpaneel

Open je webbrowser en ga naar het IP-adres van je server gevolgd door poort 8080 (bijvoorbeeld http://IP_SERVER:8080). Je komt terecht op het startscherm van het paneel dat gewijd is aan het beheer van je servers.

6

De eerste externe server toevoegen

Registreer je eerste doelmachine vanuit het webpaneel door het adres en de vereiste inloggegevens voor de initiële koppeling in te voeren. Het systeem genereert de versleutelde SSH-sleutel, waarmee de veilige toegang voor toekomstige onderhoudswerkzaamheden wordt vastgelegd.

Gebruikshandleiding

Navigatie in het webbeheerpaneel

Het dashboard dat toegankelijk is via poort 8080 centraliseert de status van al je geregistreerde machines. Je kunt er de algemene status van je serverpark bekijken, de laatst uitgevoerde bewerkingen controleren en de volledige actiehistorie doornemen. Deze ruimte vormt het centrale punt om je technische interventies te coördineren zonder meerdere SSH-sessies te openen.

Taken inplannen en SSD trim

Stel in de planningssectie de frequentie in waarmee je systeempakketten moeten worden gecontroleerd en geupgraded. Je kunt ook SSD trim-optimalisatie integreren om goede prestaties op je flash-opslagmedia te behouden. Eenmaal opgeslagen, draait de routine automatisch op de achtergrond volgens het ingestelde schema.

Instellen van meldingen en de Discord-bot

Om op afstand op de hoogte te blijven, stel je je meldingskanalen in door een Discord-webhook in te voeren of de geïntegreerde bot te activeren. In de bot-modus ontvang je gedetailleerde overzichten na elke taakuitvoering. Deze verrijkte notificaties bevatten interactieve knoppen om een machine met één klik te herstarten of een herstart in te plannen.

Beheer van NetBird-instanties

Als je infrastructuur op NetBird is gebaseerd, ondersteunt de software het versiebeheer van je componenten. Je kunt upgrades toepassen op zowel de client als de NetBird SelfHosted-infrastructuur, rechtstreeks via de tool. Deze native integratie zorgt voor consistente versies binnen je overlay-netwerk zonder ingewikkelde handmatige handelingen.

Logboekbewaking en traceerbaarheid

Raadpleeg regelmatig de historie van de bewerkingen op de interface om de acties te auditeren die op je machines zijn uitgevoerd. In het geval van een storing in een dienst na een upgrade, kun je in het logboek precies controleren welke pakketten op welk moment zijn verwerkt. Dit inzicht vergemakkelijkt de analyse en het preventieve onderhoud van je omgevingen.

Deze gebruikstips zijn opgesteld om je te helpen het maximale uit je controlepaneel te halen en de veiligheid van je serverpark te optimaliseren. Breng deze aanbevelingen in de praktijk om de stabiliteit van je Linux-omgevingen te waarborgen.

Tips

Kies bij voorkeur voor een dedicated LXC-container

Installeer de tool in een schone LXC-instantie om het beheer van je servers te scheiden van je reguliere applicatie-workloads. Dit vereenvoudigt algehele back-ups en behoudt de integriteit van je bewakingsserver.

Plan buiten piekuren

Plan je updatecycli en SSD trim tijdens de rustige nachtelijke uren. Zo voorkom je onverwachte schijfvertragingen of tijdelijke onbeschikbaarheid voor je gebruikers.

Benut de Discord-actieknoppen

Configureer de Discord bot-modus in plaats van een passieve webhook om te profiteren van de interactieve herstartknoppen. Hiermee kun je een systeemherstart bevestigen vanaf je mobiel zonder te hoeven inloggen op het dashboard.

Houd kernelpakketten in de gaten

Let goed op meldingen die wijzen op een Linux kernel-update. Plan op dat moment snel een herstart van de host om de nieuwe veilige versie te laden, zonder dat de machine in een tussenfase achterblijft.

Controleer je geregistreerde SSH-sleutels

Omdat de tool de gegenereerde SSH-sleutels automatisch versleutelt, moet je de rechten van de sleuteldirectories op de doelsystemen niet handmatig wijzigen. Laat de tool de eigen toegang beheren om onderbrekingen in de communicatie te voorkomen.

Centraliseer je NetBird-nodes

Groepeer de bewaking van je NetBird-clients en je SelfHosted-server op hetzelfde dashboard. Dit garandeert een perfecte homogeniteit van protocollen en beperkt het risico op incompatibiliteit tussen netwerkversies.

Raadpleeg de historie vóór grote wijzigingen

Voordat je een nieuwe zware toepassing op een externe server installeert, controleer je in de historie of het laatste onderhoud zonder fouten is voltooid. Zo start je vanaf een volledig gezonde en up-to-date softwarebasis.

Controleer de bereikbaarheid van poort 8080

Als je je machines via een extern netwerk beheert, overweeg dan om het webpaneel achter een beveiligde tunnel te plaatsen of om de IP-adressen die toegang hebben tot poort 8080 strikt te filteren.

In het geval van onvoorziene problemen bij de toegang tot het webpaneel of de communicatie met een externe machine, raadpleeg je dit onderdeel voor probleemoplossing. Het bevat concrete oplossingen voor de meest voorkomende technische blokkades.

Probleemoplossing

⚠️ De webinterface op poort 8080 laadt niet na de installatie
Controleer of de dienst actief is op je hostmachine door de lopende processen in de terminal te raadplegen. Zorg ervoor dat de lokale firewall verbindingen op poort 8080 niet blokkeert en controleer of het gebruikte IP-adres bereikbaar is vanaf je werkstation.
⚠️ Verbindingsfout bij het toevoegen van een nieuwe doelmachine
Controleer of de externe server bereikbaar is via het netwerk en of de SSH-dienst daar correct werkt. Controleer of de ingevoerde tijdelijke beheerdersinloggegevens juist zijn, zodat de software de initiële versleutelde sleutel kan uitrollen.
⚠️ Discord-meldingen komen niet aan op de chatserver
Controleer de webhook-URL of het token van de Discord-bot die is geconfigureerd in de instellingen van het paneel. Zorg ervoor dat het doeltekstkanaal de bot rechten geeft om te schrijven en verrijkte berichten (embeds) te sturen.
⚠️ Interactieve Discord-knoppen starten de herstart niet
Zorg ervoor dat je de Discord bot-modus gebruikt en niet een eenvoudige webhook, aangezien die laatste geen interactiviteit ondersteunt. Controleer ook of de uitgaande communicatie van je host naar de Discord API niet wordt geblokkeerd.
⚠️ SSD trim mislukt op een specifieke server
Controleer of de opslag van de doelmachine daadwerkelijk gebruikmaakt van een SSD-medium dat compatibel is met het commando fstrim. In het geval van een virtuele machine of container moet de optie voor SSD-emulatie of toegang tot discard-commando's zijn ingeschakeld op de hypervisor.
⚠️ De update van NetBird SelfHosted vordert niet meer
Raadpleeg de historielogs in de webinterface om eventuele pakket- of containerconflicten te identificeren. Zorg ervoor dat de NetBird-instantie voldoende schijfruimte heeft om de nieuwe binaire bestanden te downloaden en uit te pakken.
⚠️ Onderbreking van het curl-commando tijdens de initiële installatie
Controleer de stabiliteit van je internetverbinding en zorg ervoor dat de pakketten curl en sudo zijn geïnstalleerd op je basissysteem. Voer vervolgens het commando curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash opnieuw uit in je terminal.
⚠️ De geplande herstart is niet op de geplande tijd uitgevoerd
Controleer de tijdsynchronisatie (tijdzone en NTP-dienst) tussen de server die de Updater uitvoert en de externe machine. Een tijdsverschil kan de uitvoering van geplande taken vertragen.

Neem kennis van de minimale hardware- en systeemeisen die essentieel zijn voor een optimale werking van het webpaneel en de achtergrondtaken. De tool is ontworpen om zeer zuinig te blijven en past zich aan bescheiden hardwareconfiguraties aan.

Vereisten

Minimaal

OSModerne Linux-distributie (aanbevolen in schone LXC-container)
CPU1-core 64-bit processor
RAM512 MB werkgeheugen
Opslag1 GB vrije schijfruimte
NetwerkInternetverbinding voor downloads en pakketbronnen

Aanbevolen

OSModerne Linux-distributie in dedicated LXC-container
CPU2-core processor
RAM1 GB werkgeheugen of meer
Opslag5 GB vrije schijfruimte voor historie en logboeken
NetwerkBreedbandverbinding en poort 8080 open op het lokale netwerk