Troubleshooting

Windows "Manual Mode" - Service Not Created

If the installer shows "INSTALLATION COMPLETE (Manual Mode)" or "NSSM DOWNLOAD FAILED", the Windows service couldn't be created.

Cause

The service wrapper (NSSM) failed to download, usually due to firewall or antivirus blocking the download.

Solution 1: Re-run the installer

iwr -useb https://managedbyai.dev/install.ps1 | iex; Install-Atlas YOUR_API_KEY

Solution 2: Disable antivirus temporarily

• Temporarily disable Windows Defender or your antivirus
• Re-run the installer
• Re-enable antivirus after installation

Solution 3: Start Atlas manually

If the service still won't install, you can run Atlas manually:

& "C:\Program Files\Atlas\atlas-agent.exe" daemon -c "C:\ProgramData\Atlas\config.yaml"

Keep this PowerShell window open. Atlas will run until you close it.

Windows Service Exists But Not Running

The service was created but won't start.

Check service status

Get-Service AtlasAgent

Try starting manually

Start-Service AtlasAgent

Check logs for errors

Get-Content "C:\ProgramData\Atlas\atlas-stderr.log" -Tail 50

Common causes

• Invalid API key: Check your API key in C:\ProgramData\Atlas\config.yaml
• Firewall blocking outbound: Atlas needs to connect to atlas-ws.managedbyai.dev on port 443
• Config file corrupted: Delete config.yaml and re-run installer

Windows Server Not Appearing in Dashboard

Atlas is running but your server doesn't show in the dashboard.

Verify service is running

Get-Service AtlasAgent

Should show Status: Running

Check the logs

Get-Content "C:\ProgramData\Atlas\atlas-stderr.log" -Tail 20

Look for "connected" or error messages.

Verify API key

Get-Content "C:\ProgramData\Atlas\config.yaml"

Make sure api_key matches the key from your dashboard.

Test connectivity

Test-NetConnection atlas-ws.managedbyai.dev -Port 443

Should show TcpTestSucceeded: True

Linux Service Failed to Start

Check service status

sudo systemctl status atlas-daemon

View logs

sudo journalctl -u atlas-daemon -n 50

Restart the service

sudo systemctl restart atlas-daemon

Check config

cat /etc/atlas/config.yaml

Verify your API key is correct.

Linux Permission Denied Errors

Solution

The installer must be run with sudo:

curl -sL https://managedbyai.dev/install.sh | sudo bash -s -- YOUR_API_KEY

All Platforms Invalid API Key

Error: "Invalid API key" or "Rejected API key"

Solution

• Log in to your dashboard
• Copy your API key (starts with atlas_)
• Re-run the installer with the correct key

All Platforms Connection Issues

Atlas can't connect to the relay server.

Check your firewall

Atlas needs outbound access to:

• atlas-ws.managedbyai.dev port 443 (WebSocket)
• managedbyai.dev port 443 (HTTPS for updates)

Corporate proxy

If you're behind a corporate proxy, Atlas may not work. Contact your IT team to allow the above domains.

All Platforms How to Uninstall

Windows

& "C:\Program Files\Atlas\nssm.exe" stop AtlasAgent
& "C:\Program Files\Atlas\nssm.exe" remove AtlasAgent confirm
Remove-Item -Recurse "C:\Program Files\Atlas"
Remove-Item -Recurse "C:\ProgramData\Atlas"

Linux

sudo systemctl stop atlas-daemon
sudo systemctl disable atlas-daemon
sudo rm /usr/local/bin/atlas-agent
sudo rm /etc/systemd/system/atlas-daemon.service
sudo rm -rf /etc/atlas

macOS

sudo launchctl unload /Library/LaunchDaemons/dev.managedbyai.atlas.plist
sudo rm /Library/LaunchDaemons/dev.managedbyai.atlas.plist
sudo rm /usr/local/bin/atlas-agent
sudo rm -rf /etc/atlas