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 source + update
curl -fsSL https://apt.maxtaos.com/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/maxtaos.gpg && \
echo "deb [signed-by=/etc/apt/keyrings/maxtaos.gpg] https://apt.maxtaos.com/repo noble main" | \
sudo tee /etc/apt/sources.list.d/maxtaos.list > /dev/null && \
sudo apt update

Step-by-Step Guide

1 Import GPG Signing Key

# Download and install the MaxtaOS repository signing key
curl -fsSL https://apt.maxtaos.com/gpg.key \
  | sudo gpg --dearmor \
  -o /etc/apt/keyrings/maxtaos.gpg

# Verify the key was installed
file /etc/apt/keyrings/maxtaos.gpg

2 Add Repository Source

# Add the MaxtaOS stable repository
echo "deb [signed-by=/etc/apt/keyrings/maxtaos.gpg] \
  https://apt.maxtaos.com/repo noble main" \
  | sudo tee /etc/apt/sources.list.d/maxtaos.list

# Update package index
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 /etc/apt/sources.list.d/maxtaos.list
sudo rm /etc/apt/keyrings/maxtaos.gpg
sudo apt update