⚡️ Aaxion

Aaxion is a lightweight, high-performance file server designed to repurpose old hardware into efficient storage nodes. I built this to utilize my old laptop's 1TB storage as a dedicated file cloud for my main devices.

---

🚀 Key Features

• Zero-Buffer Streaming: Uploads and downloads are streamed directly to disk/network. A 10GB file transfer uses only ~32KB of RAM.
• Resumable Uploads: Supports chunked uploading to bypass network limits (e.g., Cloudflare Tunnel) and resume interrupted transfers.
• Temporary Sharing: Generate one-time secure links for external file sharing.
• Cross-Platform: Written in Go, runs on Linux (primary) and Windows.

---

📥 Installation

Aaxion is distributed as a single binary. Run this command on your Linux or macOS server to instantly install the latest release:

curl -fsSL https://aaxion.codershubinc.com/install.sh | bash

Next, create an admin user and start the server:

aax create-admin user:pass
aax serve

The server will start on port 8080.

---

⚙️ How it Works

(Current Version: Linux optimized, Windows experimental)

• Service: On Linux, it runs efficiently as a systemd background service.
• File System: It monitors a specified root directory (e.g., /home/swap/*) and serves the file tree via JSON APIs.
• Security: Built-in path sanitization prevents directory traversal attacks. Hidden files (starting with .) are automatically excluded.
• API: Check the full API Documentation here.

---

📱 Usage

Aaxion is designed to work with the Aaxion Mobile App:

1. Download the app from the Aaxion-Mob Repository.
2. Open the app and navigate to Settings.
3. Enter your server's IP address and Port (Default: 8080).
4. Browse, upload, and share files directly from your phone.

---

📊 Resource Usage

Aaxion is engineered for extreme efficiency using Go's io.Copy streaming interfaces. It does not load files into memory.

Idle State

• CPU: ~0.0% - 0.1%
• RAM: ~10 MB
• Footprint: Minimal background noise, perfect for older hardware.

Under Load (Heavy Transfer)

Even while uploading a 10GB file, the resource usage remains flat because data is piped directly to the disk.

• CPU: ~0.8% - 1.0% (I/O Wait)
• RAM: ~20 MB (Peak)
• Disk: ~1 MB (Log storage)

License

Aaxion is free software licensed under the GNU Affero General Public License v3.0. Copyright (C) 2026 Swapnil Ingle.

Note: If you deploy this server and allow others to use it, you must provide them with access to the source code (including your modifications).