Installation

StaxPing is designed to be easy to install and run across supported platforms.
This page explains how to install the tool on Linux, how to use the AppImage, how Windows support will work, and how to build from source if needed.

Linux Installation (.deb)

The .deb package is the primary distribution format for StaxPing on Debian/Ubuntu‑based systems.

Download the latest release:

wget `https://github.com/ZFordDev/StaxPing/releases/latest/download/staxping_amd64.deb` [(github.com in Bing)](https://www.bing.com/search?q="https%3A%2F%2Fgithub.com%2FZFordDev%2FStaxPing%2Freleases%2Flatest%2Fdownload%2Fstaxping_amd64.deb")
sudo dpkg -i staxping_amd64.deb

If any dependencies are missing:

sudo apt --fix-broken install

Once installed, the staxping command becomes available system‑wide.

Linux Installation (AppImage)

An AppImage build is also available for users who prefer a portable, no‑install option.

Download the AppImage
Make it executable:
```
chmod +x StaxPing.AppImage
```
Run it directly:
```
./StaxPing.AppImage
```

The AppImage does not modify your system and can be stored anywhere.

Windows Installation (.exe)

A standalone Windows .exe will be provided once Linux packaging is fully stabilized.

Planned behavior:

No installer required
First‑run setup identical to Linux
Config stored in %APPDATA%\StaxPing\config.json
Works from any directory or added to PATH manually

Windows support is part of an upcoming milestone.

Manual Build From Source

StaxPing is written in Rust and can be built manually on any platform with a Rust toolchain installed.

Clone the repository:

git clone `https://github.com/ZFordDev/StaxPing.git` [(github.com in Bing)](https://www.bing.com/search?q="https%3A%2F%2Fgithub.com%2FZFordDev%2FStaxPing.git")
cd StaxPing

Build in release mode:

cargo build --release

The compiled binary will be located at:

target/release/staxping

This method is recommended for contributors or users on unsupported platforms.

First‑Run Behavior

On first launch, StaxPing performs a one‑time setup to ensure consistent behavior across systems.

It will:

Display the EULA
Detect your operating system
Check available capabilities (DNS, ICMP, HTTP, traceroute)
Create a small config file:

Linux:

$HOME/.config/staxping/config.json

Windows:

%APPDATA%\StaxPing\config.json

After this initial setup, StaxPing runs instantly with no further prompts.