Installation Guide

This guide walks you through installing the Atlas Daemon on your game servers.

Prerequisites

Linux server (Alpine, Ubuntu, Debian, or RHEL-based)
Pterodactyl Panel with Wings (recommended), or standalone server
Network access to api.atlas.dev (port 443)

Quick Install (Recommended)

The fastest way to get started:

curl -fsSL https://get.atlas.dev/daemon | ATLAS_TOKEN=your_token bash

This one-liner:

Downloads the latest daemon
Installs it to /usr/local/bin/atlasd
Creates the configuration
Connects to your Atlas account
Starts monitoring your server

Docker (Pterodactyl)

If you're using Pterodactyl, add the daemon to your egg:

Startup Command:

atlasd run -- /bin/sh /var/lib/pterodactyl/volumes/start.sh

Environment Variables:

ATLAS_ENROLLMENT_TOKEN — Your enrollment token
ATLAS_DATA_ROOT — Path to your server files

Manual Installation

For more control:

# Download the daemon
curl -fsSL https://releases.atlas.dev/daemon/latest/atlasd-linux-amd64 -o /usr/local/bin/atlasd
chmod +x /usr/local/bin/atlasd

# Enroll with your token
atlasd enroll --token your_token

# Start the daemon
atlasd run -- /path/to/your/start.sh

Systemd Service

For standalone servers, run as a service:

# Copy the service file
sudo cp deploy/atlasd.service /etc/systemd/system/

# Enable and start
sudo systemctl daemon-reload
sudo systemctl enable atlasd
sudo systemctl start atlasd

# Check status
sudo systemctl status atlasd

After Installation

Once installed, your server will appear in your Atlas dashboard within seconds. You can then monitor server health in real-time, access the console, send commands, and set up automation pipelines.

Troubleshooting

Server not showing up?

Check the daemon is running: systemctl status atlasd
View logs: journalctl -u atlasd
Verify network access: curl -I https://api.atlas.dev

Can't connect?

Ensure your firewall allows outbound HTTPS/WebSocket
Check your enrollment token is valid
Verify the server can resolve api.atlas.dev