Your First MatrixSwarm: Five Agents, One Railgun, and a Server That Finally Texts Back

Description and use

Setting up MatrixSwarm on a Linux server: install MatrixOS, create a Phoenix workspace, configure HTTPS, WSS, and Telegram, launch five agents, and receive SSH login alerts.

Problem

Deploy a MatrixSwarm on a Linux server that allows Phoenix to send commands over HTTPS, receive live logs via WebSocket, and get a Telegram alert when an SSH login succeeds.

Outcome

The setup enables secure command execution, real‑time log streaming, and instant SSH login notifications via Telegram.

Workflow

• Prepare target machine and vault
• Create SSH record in Registry
• Run Railgun preflight check and install MatrixOS
• Create HTTPS, WSS, and Telegram records in Registry
• Deploy swarm via Phoenix workspace
• Verify SSH login triggers Telegram alert

Evidence

Install MatrixOS, create a Phoenix Swarm Workspace, assign its connections, deploy it through Railgun, and verify the complete path with a controlled login.

Source

The five agents we add are matrix_https, matrix_websocket, log_streamer, telegram_relay, and gatekeeper.

Source

Gatekeeper watches authentication-log entries for successful SSH logins.

Source