...

AKR Updater

1.7.0

...

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

This comprehensive user guide will help you get started with AKR Updater and all of its maintenance features. You’ll learn how to navigate the dedicated web panel, schedule your system updates, and perform SSD trim maintenance. This document also details the management of encrypted SSH keys, NetBird support, and interaction with the Discord bot. Follow these practical sections to optimize the management of your Linux infrastructure.

The AKR Updater installation has been designed to be as fast and simple as possible on Linux systems. With a single Curl command executed in your terminal, the tool deploys in a fraction of a second—ideally on a new LXC container. Before you begin, make sure you have terminal access and an internet connection. Follow this step-by-step guide to configure your server and access the web panel on port 8080.

Installation

1

Setting Up the Linux Terminal

Open a terminal session on your Linux server or connect to it remotely via SSH. Make sure you have access to a modern, clean Linux environment—ideally a brand-new LXC container. Verify that the `curl` tool is available on your system so you can download the installation script.

2

Running the One-Time Installation Command

Copy and paste the official installation command into your terminal: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. This command securely downloads the installation script and runs it directly with the required privileges. Do not modify the URL or the parameters in this command line.

3

Automatic Download and Setup

The installation script automatically configures dependencies and prepares the AKR Updater files in a fraction of a second. The tool sets up the components needed for the web service and task management. You do not need to perform any manual steps during this phase.

4

Access to the Web Administration Panel

Once the script has finished running, open your usual web browser on a workstation. Enter your server's IP address followed by the dedicated port 8080 (for example, http://192.168.1.100:8080). The intuitive AKR Updater web interface will then appear on the screen.

5

Initial Configuration of SSH Usernames and Passwords

Enter your login credentials the first time you log in to set up the system. AKR Updater will automatically generate and encrypt a dedicated SSH key to secure communications. No passwords are stored in plain text on the server, ensuring a high level of security.

6

Connecting Notification Services (Discord / Webhook)

Go to the settings section of the web panel to link your Webhook or Discord bot. Configure the alerts to receive interactive embeds and quick-action buttons. Your AKR Updater v1.7.0 installation is now fully operational and ready to manage your machines.

Usage Guide

Getting Started with the Web Administration Panel on Port 8080

The AKR Updater web panel is the heart of your centralized management system. Accessible via port 8080, its various menus provide you with visual and intuitive control over your entire Linux fleet. There, you can add new machines, view their status in real time, and browse the detailed history of every operation performed.

Automation of System Updates and SSD Maintenance

The interface allows you to set up custom scheduling rules for your servers. You can schedule regular package updates as well as the execution of the `trim SSD` command to preserve your drives. The tool runs these tasks in the background without requiring repetitive manual intervention.

Centralized Updates for NetBird Components

AKR Updater supports the maintenance of NetBird-based private network architectures. From the web interface, you can monitor and initiate updates for NetBird clients as well as the NetBird SelfHosted version. This ensures that your network infrastructure remains up to date and fully secure at all times.

Using the Discord Bot and Interactive Action Buttons

By integrating the tool with a Discord bot, you can turn your alerts into a remote command center. When packets require a machine restart, the bot sends a rich message in the form of an embed. Simply interact with the buttons embedded in the message to perform an immediate restart or schedule one for later.

Securing Access Through Automatic SSH Key Encryption

The AKR Updater architecture eliminates the risks associated with storing passwords in plain text. When you enter your credentials for the first time, the application generates a dedicated SSH key that is immediately encrypted. Only the tool is authorized to use this secure key to interact with your remote servers.

Discover a selection of tips and best practices to get the most out of AKR Updater on your Linux servers. These tips will help you optimize deployment in LXC containers and strengthen the security of your access. You’ll also learn how to make the most of the Discord Bot’s interactive features and SSD trim scheduling. Follow these recommendations to maintain a stable and high-performing IT infrastructure.

Tips

Consider installing on an LXC container

For optimal performance, deploy AKR Updater in a new, dedicated LXC container. Its inherently lightweight design allows it to run quickly without wasting your host's resources.

Use Discord Bot mode instead of a simple webhook

Set up a Discord bot instead of a simple webhook to take advantage of interactive buttons. This will allow you to manage machine reboots directly from your Discord app.

Schedule SSD trimming during off-peak hours

Schedule the SSD trim task for times of low activity on your servers. Although this disk maintenance operation is fast, it is best performed overnight.

Check the history on port 8080 regularly

Get into the habit of checking the "History" tab on the web panel. This gives you an accurate overview of the packages that have been updated and allows you to track changes to your servers.

Centralize the management of your NetBird instances

Take advantage of AKR Updater's NetBird SelfHosted integration to synchronize client and server versions. This will help you avoid any network compatibility issues after an update.

Check the firewall rules for port 8080

Make sure port 8080 is properly open on your local network to access the web interface. You can restrict this access to only the IP addresses in your administration subnet.

Take advantage of the quick installation order

Don't waste time compiling or downloading packages manually. Use only the official `curl` command to ensure a clean deployment in a second.

Schedule restarts after an update

If a Linux kernel update occurs, use the Discord scheduling button to postpone the server restart until a time when no users are online.

This troubleshooting section is designed to help you quickly resolve any issues you may encounter while using AKR Updater. Whether you’re having trouble accessing port 8080, encountering an error when running the Curl command, or experiencing issues with Discord notifications, practical solutions are provided. Each scenario includes step-by-step instructions to restore your tool to proper working order. Identify your problem and follow the recommended solution.

Troubleshooting

⚠️ Unable to access the web interface on port 8080
First, verify that the AKR Updater service is running on your terminal. Also check your Linux distribution's firewall to ensure that port 8080 allows incoming traffic. Enter the exact IP address followed by port 8080 again in your web browser.
⚠️ Error while running the Curl installation command
Make sure the curl package is properly installed on your Linux server. Carefully re-run the exact command: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Also verify that your server has an active internet connection to download the script.
⚠️ The Discord bot isn't responding or sending notifications
Verify the Discord bot credentials and token entered in the AKR Updater web panel. Make sure the bot has the necessary permissions to post messages and embed buttons in the target channel. Test the configuration by sending a test notification from the interface.
⚠️ The restart buttons on Discord aren't working
Verify that the server running AKR Updater is still online and connected to the internet. The Discord bot needs an active connection to the web panel to send restart commands. Also make sure that the encrypted SSH key for the target server is still valid.
⚠️ Failed SSH connection to a server in the network
Access the administration panel on port 8080 and re-enter the machine's credentials. AKR Updater will generate a new SSH key and automatically encrypt it to reestablish communication. Make sure the SSH service on the remote server is working properly.
⚠️ The NetBird SelfHosted update fails
Verify that the dependencies specific to your NetBird installation are correctly configured on the target machine. Check the error log in the AKR Updater web panel to identify the step that is causing the blockage. Make sure that the NetBird Client and Server packages are not locked by another process.
⚠️ The SSD trim does not perform any operations on the machine
Verify that the storage on your Linux server or container supports the `trim` command. In some virtualized environments, this option must be enabled at the hypervisor level to pass the command to the physical disk. Check the execution logs in the web interface to confirm the status.
⚠️ The update history is not displayed in the web panel
Refresh the web browser page connected to port 8080. If the problem persists, restart the AKR Updater service from your Linux terminal to reset the interface display. Your previously saved history data will not be lost.

Review the hardware and software requirements needed to run AKR Updater optimally on your Linux server. Thanks to its extremely lightweight design, the tool requires very few processor or memory resources. It installs seamlessly in a lightweight LXC environment while providing a smooth web interface on port 8080. Check the minimum and recommended configurations below before proceeding with deployment.

Requirements

Minimum

OSModern Linux distribution (e.g., LXC environment)
CPU1 processor core
RAM512 MB of RAM
Storage100 MB of free space
NetworkAn Internet connection is required for downloads and alerts

Recommended

OSModern Linux distribution on a dedicated LXC container
CPU2 or more processor cores
RAM1 GB of RAM
Storage500 MB of free space
NetworkHigh-speed Internet connection with access to port 8080