Get Started

Add the MaxtaOS repository to your node in under 60 seconds. One command to connect, one command to install.

Quick Setup — single command Recommended

# One-liner: import key + add deb822 source + update
sudo install -d -m 0755 /etc/apt/keyrings && \
curl -fsSL https://apt.maxtaos.com/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/maxtaos.gpg && \
sudo tee /etc/apt/sources.list.d/maxtaos.sources >/dev/null <<'EOF'
Types: deb
URIs: https://apt.maxtaos.com/repo
Suites: noble
Components: main
Signed-By: /etc/apt/keyrings/maxtaos.gpg
EOF
sudo apt update

Step-by-Step Guide

1 Import GPG Signing Key

# Create the keyrings dir and install the MaxtaOS signing key (dearmored)
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.maxtaos.com/gpg.key \
  | sudo gpg --dearmor \
  -o /etc/apt/keyrings/maxtaos.gpg

# Verify the key installed and contains the signing subkey 00CD6975F05D18A7
gpg --show-keys /etc/apt/keyrings/maxtaos.gpg

2 Add Repository Source (deb822)

# Add the MaxtaOS stable repository in deb822 format (recommended on noble)
sudo tee /etc/apt/sources.list.d/maxtaos.sources >/dev/null <<'EOF'
Types: deb
URIs: https://apt.maxtaos.com/repo
Suites: noble
Components: main
Signed-By: /etc/apt/keyrings/maxtaos.gpg
EOF

# Update package index — must show NO GPG errors
sudo apt update

3 Install Packages

# List available MaxtaOS packages
apt list --upgradable 2>/dev/null | grep maxtaos

# Install the base release package
sudo apt install maxtaos-release

4 Register Node (Optional)

# Register this node with the control plane
curl -X POST https://apt.maxtaos.com/api/node/register.php \
  -H "Content-Type: application/json" \
  -d '{
    "node_id": "'$(hostname)'",
    "hostname": "'$(hostname -f)'",
    "maxtaos_ver": "1.0",
    "kernel_ver": "'$(uname -r)'",
    "gpu_model": "'$(lspci | grep -i vga | head -1)'"
  }'

Requirements

Supported OS
Ubuntu 24.04 LTS (noble) — amd64
MaxtaOS 1.x (based on noble)

Dependencies
curl, gpg, apt (pre-installed on all supported systems)

Uninstall / Remove

# Remove the MaxtaOS repository
sudo rm -f /etc/apt/sources.list.d/maxtaos.sources /etc/apt/sources.list.d/maxtaos.list
sudo rm -f /etc/apt/keyrings/maxtaos.gpg
sudo apt update