Linux Installation

Install MUXI Server and CLI with a single command. Works on Ubuntu, Debian, Fedora, CentOS, Arch, and most other distributions.

Quick Install

System-wide (recommended for production):

curl -fsSL https://muxi.org/install | sudo bash

User-level (no sudo):

curl -fsSL https://muxi.org/install | bash

Distribution-Specific

Ubuntu / Debian

# Install dependencies
sudo apt update
sudo apt install -y curl

# Install MUXI
curl -fsSL https://muxi.org/install | sudo bash

RHEL / CentOS / Fedora

# Install dependencies
sudo dnf install -y curl

# Install MUXI
curl -fsSL https://muxi.org/install | sudo bash

Arch Linux

# Install dependencies
sudo pacman -S curl

# Install MUXI
curl -fsSL https://muxi.org/install | sudo bash

Manual Install

# Download latest release
curl -LO https://github.com/muxi-ai/server/releases/latest/download/muxi-server-linux-amd64.tar.gz

# Extract
tar -xzf muxi-server-linux-amd64.tar.gz

# Move to PATH
sudo mv muxi-server /usr/local/bin/
sudo mv muxi /usr/local/bin/

# Verify
muxi --version

For ARM64, use linux-arm64 instead of linux-amd64.

Running as a Service

systemd (Recommended)

Create /etc/systemd/system/muxi-server.service:

[Unit]
Description=MUXI Server
After=network.target

[Service]
Type=simple
User=muxi
Group=muxi
ExecStart=/usr/local/bin/muxi-server serve
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Enable and start:

# Create service user
sudo useradd -r -s /bin/false muxi

# Enable and start
sudo systemctl daemon-reload
sudo systemctl enable muxi-server
sudo systemctl start muxi-server

# Check status
sudo systemctl status muxi-server

View Logs

sudo journalctl -u muxi-server -f

Configuration

Production Setup

1. Create dedicated user:

   bash sudo useradd -r -s /bin/false muxi

2. Set permissions:

   bash sudo chown -R muxi:muxi /etc/muxi

3. Configure firewall:

   bash sudo ufw allow 7890/tcp

4. Enable service:

   bash sudo systemctl enable muxi-server

Next Steps

• Quickstart - Create your first formation
• Production Deployment - Production best practices