...

AKR Updater

1.7.3

...

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

This practical guide details the step-by-step use of the software, from discovering the web interface to setting up your first scheduled tasks. You will also learn how to link your Discord account to control your reboots remotely.

Before launching the application deployment, discover the procedure to quickly configure your host by the book. The entire procedure relies on a single shell command executed in your Linux terminal.

Installation

1

Preparing the Linux environment

Start a Linux system or create a dedicated, clean LXC container to host the service. Make sure you have terminal access with sudo administrative privileges and an active network connection to download the necessary files.

2

Executing the installation command

Open your terminal and paste the exact following command: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Confirm execution to launch the official automated installation script.

3

Waiting for automatic configuration

Let the installation process deploy the files and configure the background services. The script runs autonomously in a few seconds to prepare the components necessary for the system to operate.

4

Checking network ports

Verify that TCP port 8080 is accessible from your local network or allow it in your application firewall rules. This port is essential for communicating with the graphical administration interface hosted by the software.

5

Accessing the web administration panel

Launch your web browser and go to your server's IP address followed by port 8080 (for example http://SERVER_IP:8080). You will arrive at the home screen of the panel dedicated to managing your servers.

6

Adding the first remote server

From the web panel, register your first target machine by entering its address and the credentials required for the initial connection. The system will generate the encrypted SSH key, sealing secure access for future maintenance operations.

Usage Guide

Navigating the web administration panel

The dashboard accessible on port 8080 centralizes the status of all your registered machines. You can observe the overall health of your fleet, check the latest executed operations, and browse the complete history of actions. This space serves as the nerve center for orchestrating your technical interventions without opening multiple SSH sessions.

Scheduling tasks and SSD trim

From the scheduling section, define how often your system packages should be inspected and upgraded. You can also integrate SSD trim optimization to maintain good performance on your flash storage media. Once saved, the routine runs automatically in the background according to the established schedule.

Configuring alerts and the Discord bot

To ensure remote monitoring, set up your alert channels by entering a Discord webhook or by activating the built-in bot. In bot mode, you will receive detailed embeds after each task execution. These rich notifications integrate interaction buttons allowing you to restart a machine or schedule its reboot with a single click.

Administering NetBird instances

If your infrastructure relies on NetBird, the software handles version management for your components. You can apply upgrades to both the client and the NetBird SelfHosted infrastructure directly via the tool. This native integration ensures version consistency across your overlay network without complex manual manipulation.

Log monitoring and tracking

Regularly check the operation history in the interface to audit the actions performed on your machines. In case of a service anomaly following an upgrade, the log allows you to precisely verify which packages were processed and at what time. This visibility facilitates analysis and preventative maintenance of your environments.

These usage tips have been formulated to help you get the most out of your control panel and optimize your fleet's security. Put these recommendations into practice to preserve the stability of your Linux environments.

Tips

Prioritize a dedicated LXC container

Install the tool inside a blank LXC instance to isolate your server administration from your current application workloads. This simplifies global backups and preserves the integrity of your monitoring server.

Schedule outside of peak hours

Program your update and SSD trim cycles during off-peak night hours. This will prevent any unexpected disk slowdowns or temporary downtime for your users.

Leverage Discord action buttons

Configure the Discord bot mode rather than a passive webhook to benefit from interactive reboot buttons. This allows you to validate a system restart from your mobile device without having to log into the dashboard.

Monitor kernel packages

Pay attention to notifications signaling a Linux kernel update. Then schedule a quick host reboot to load the new secure version without leaving the machine in an intermediate state.

Check your saved SSH keys

Since the tool automatically encrypts generated SSH keys, make sure not to manually modify key directory permissions on targets. Let the tool manage its access to prevent any communication breaks.

Centralize your NetBird nodes

Group the monitoring of your NetBird clients and your SelfHosted server on the same dashboard. This guarantees perfect protocol homogeneity and limits compatibility risks between network versions.

Check history before any major change

Before installing a new heavy application on a remote server, check the history to ensure the last maintenance completed without errors. You will thus start from a perfectly sound and up-to-date software foundation.

Check port 8080 connectivity

If you manage your machines via a remote network, consider placing the web panel behind a secure tunnel or strictly filtering the IP addresses allowed to reach port 8080.

In case of unexpected issues accessing the web panel or communicating with a remote machine, consult this troubleshooting section. It gathers concrete solutions to the most commonly encountered technical roadblocks.

Troubleshooting

⚠️ The web interface on port 8080 refuses to load after installation
Verify that the service is active on your host machine by checking running processes in the terminal. Make sure the local firewall is not intercepting connections on port 8080 and check that the IP address used is reachable from your workstation.
⚠️ Connection failure when adding a new target machine
Check that the remote server is reachable over the network and that the SSH service is running correctly on it. Verify that the temporary administrator credentials entered are accurate so the software can deploy its initial encrypted key.
⚠️ Discord alerts are not reaching the discussion server
Inspect the webhook URL or Discord bot token configured in the panel settings. Make sure the targeted text channel grants write permissions and the ability to send rich messages (embeds) to the bot.
⚠️ Discord interactive buttons do not trigger the reboot
Make sure you are using the Discord bot mode and not a simple webhook, as the latter does not allow interactivity. Also check that outbound communication from your host to the Discord API is not blocked.
⚠️ The SSD trim operation fails on a specific server
Check whether the target machine's storage relies on an SSD medium compatible with the fstrim command. In the case of a virtual machine or container, SSD emulation or access to discard commands must be enabled on the hypervisor.
⚠️ NetBird SelfHosted update is no longer progressing
Consult the history logs in the web interface to spot potential package or container conflicts. Make sure the NetBird instance has sufficient disk space to download and extract the new binaries.
⚠️ Interruption of the curl command during initial installation
Check your internet connection stability and make sure curl and sudo packages are installed on your base system. Then rerun the curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash command in your terminal.
⚠️ The scheduled reboot did not execute at the planned time
Check time synchronization (timezone and NTP service) between the server running the Updater and the remote machine. A clock drift can delay the execution of scheduled plans.

Review the hardware and system prerequisites essential to ensure optimal operation of the web panel and its background tasks. Designed to remain very resource-efficient, the tool adapts to modest hardware configurations.

Requirements

Minimum

OSModern Linux distribution (recommended in a fresh LXC container)
CPU1-core 64-bit processor
RAM512 MB of RAM
Storage1 GB of free space
NetworkInternet access for downloading and package repositories

Recommended

OSModern Linux distribution in a dedicated LXC container
CPU2-core processor
RAM1 GB of RAM or more
Storage5 GB of free space for histories and logs
NetworkHigh-speed connection and port 8080 open on the local network