Installing AxonASP from Linux Packages

Overview

AxonASP publishes pre-built binary packages for Linux on every tagged release. These packages install all server binaries, the default configuration, the web root, and the required directory structure under /opt/axonasp. Installation is handled by the standard package manager of your distribution.

Packages are available in three formats:

• .deb — Debian, Ubuntu, and derivatives
• .rpm — Red Hat, Fedora, CentOS, Rocky Linux, and derivatives
• .apk — Alpine Linux

Prerequisites

• A 64-bit (amd64) Linux system
• Root or sudo access
• Internet access to reach the GitHub Releases page, or a locally downloaded package file

Downloading a Package

All packages are published to the GitHub Releases page. The download URL follows this pattern:

https://github.com/guimaraeslucas/axonasp/releases/download/<version>/<file>.<extension>

Replace <version> with the release tag (for example, v2.0.1), <file> with the package filename, and <extension> with deb, rpm, or apk.

Debian/Ubuntu example:

wget https://github.com/guimaraeslucas/axonasp/releases/download/v2.0.1/axonasp_2.0.1_linux_amd64.deb

Red Hat/Fedora/Rocky example:

wget https://github.com/guimaraeslucas/axonasp/releases/download/v2.0.1/axonasp-2.0.1-1.x86_64.rpm

Alpine example:

wget https://github.com/guimaraeslucas/axonasp/releases/download/v2.0.1/axonasp_2.0.1_x86_64.apk

You can check the actual filenames for a given release on the releases page at https://github.com/guimaraeslucas/axonasp/releases.

Installing the Package

Debian and Ubuntu

sudo dpkg -i axonasp_2.0.1_linux_amd64.deb

Or, to automatically resolve any missing recommendations:

sudo apt-get install -f ./axonasp_2.0.1_linux_amd64.deb

Red Hat, Fedora, CentOS, Rocky Linux

sudo rpm -i axonasp-2.0.1-1.x86_64.rpm

Or using dnf:

sudo dnf localinstall axonasp-2.0.1-1.x86_64.rpm

Alpine Linux

sudo apk add --allow-untrusted axonasp_2.0.1_x86_64.apk

What Gets Installed

After a successful installation, the following layout is created:

Symbolic Links

The package creates symbolic links so that the server binaries are accessible from any terminal without specifying the full path.

Because the binaries are linked under /usr/bin, you can start the server from any working directory:

axonasp-http

The configuration symlink at /etc/axonasp/config/axonasp.toml provides a standard location for system administrators to locate and edit the configuration file without navigating to /opt/axonasp.

Starting the Server After Installation

After the package installs, start the HTTP server directly:

axonasp-http

To run it as a persistent background service, follow the instructions in the Running AxonASP as a Linux Service page of this manual. The package includes install-service.sh and uninstall-service.sh scripts under /opt/axonasp/ that automate systemd unit file creation.

cd /opt/axonasp
sudo bash install-service.sh
sudo systemctl start axonasp
sudo systemctl enable axonasp

Remarks

• All packages target the amd64 (x86-64) architecture. ARM builds are not included in the pre-built packages; compile from source using build.sh for other architectures.
• The temp/ subdirectories are created as empty directories by the package. The server writes bytecode caches and session data there at runtime.
• The configuration file at /opt/axonasp/config/axonasp.toml contains default values for all settings. Edit it before starting the server to configure the web root path, port, session behavior, and other options.
• The www/tests/ directory is excluded from the distributed package. It is only present in the source repository.
• Package builds are triggered automatically on every push to the main branch and on every version tag. Non-tagged builds use a commit-count-based version number (2.0.<commit-count>.<short-hash>). Tagged releases use the clean tag version (for example, 2.0.1).