Documentation
Integration guides, API reference, and configuration details for the MaxtaOS repository platform.
Repository Configuration
sources.list Format
The MaxtaOS repository uses the modern signed-by format for GPG key management.
deb [signed-by=/etc/apt/keyrings/maxtaos.gpg] https://apt.maxtaos.com/repo noble main
| Parameter | Value | Description |
|---|
| URL | https://apt.maxtaos.com/repo | Repository root |
| Distribution | noble | Ubuntu 24.04 LTS codename |
| Component | main | Primary component |
| Architecture | amd64 | 64-bit x86 only |
API Reference
POST /api/node/register.php
Node Registration
Register a MaxtaOS node with the control plane. Called on first boot and periodically as a heartbeat.
Request Body
{
"node_id": "gpu-node-01", // required, unique identifier
"hostname": "gpu-node-01.local", // optional
"maxtaos_ver": "1.0.0", // optional
"kernel_ver": "6.8.0-45-generic", // optional
"gpu_model": "AMD Instinct MI300X" // optional
}
Response
{"status": "ok", "registered": "2026-03-12T22:00:00+00:00"}
Example
curl -X POST https://apt.maxtaos.com/api/node/register.php \
-H "Content-Type: application/json" \
-d '{"node_id":"test-01","hostname":"test-node","maxtaos_ver":"1.0"}'
GET /gpg.key
GPG Public Key
Returns the ASCII-armored GPG public key used to sign all packages. RSA 4096-bit, key ID: apt@maxtaos.com
curl -fsSL https://apt.maxtaos.com/gpg.key | gpg --show-keys
GPG Verification
Verify Package Signatures
All packages in the MaxtaOS repository are signed with our GPG key. APT automatically verifies signatures when you install packages.
To manually verify:
# Import the key
curl -fsSL https://apt.maxtaos.com/gpg.key | gpg --import
# Verify Release file signature
curl -fsSL https://apt.maxtaos.com/repo/dists/noble/Release.gpg -o /tmp/Release.gpg
curl -fsSL https://apt.maxtaos.com/repo/dists/noble/Release -o /tmp/Release
gpg --verify /tmp/Release.gpg /tmp/Release
Troubleshooting
Common Issues
GPG error: NO_PUBKEY
The signing key is not installed. Run:
curl -fsSL https://apt.maxtaos.com/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/maxtaos.gpg
404 Not Found on apt update
Ensure you are using the correct URL: https://apt.maxtaos.com/repo (not /stable).
Hash Sum mismatch
This typically occurs during an active sync. Wait a few minutes and run
sudo apt update again.
Check sync status at
/status.