Deploy Your First Server

Let's create your first game server using PEON's Discord bot interface.

Prerequisites

PEON installed and running (Installation Guide)
Discord bot configured and online
Admin permissions in your Discord server

Step 1: Access PEON Interface

In your Discord server, use the slash command:

/peon admin

This opens the administrator interface with full controls.

Administrator interface screenshot will be added in v3.1.0

Step 2: Register an Orchestrator (First Time Only)

If this is your first time using PEON, you'll need to register your orchestrator:

Click "🏢 Register Orchestrator"
Fill in the modal:
Name: Main Server
URL: http://peon.orc:5000 (or your server IP)
API Key: Your configured API key from .env
Click Submit

✅ Success: You'll see "Orchestrator registered successfully!"

Step 3: Browse Available Games

Click "📚 Browse Plans" to see all supported games:

🧩 Minecraft
⚔️ Valheim
🐾 Palworld
🦕 ARK: Survival Evolved
🔫 Counter-Strike 2
🌟 Starbound
And many more!

Step 4: Create Your First Server

Method A: Using Admin Interface

Click "🏗️ Create Server"
Select your game (e.g., Valheim)
Fill in server details:
Server Name: myvalheim (no spaces)
Description: My first Valheim server
Click Submit

Method B: Using Slash Commands

Use the quick create command:

/create valheim myvalheim

Optional with description:

/create game_type:valheim server_name:myvalheim description:My awesome server

Step 5: Monitor Server Creation

PEON will:

Download game files
Configure server settings
Create secure container
Start the server

This takes 2-10 minutes depending on game size.

Step 6: Manage Your Server

Quick Server Actions

/server action:start server:valheim.myvalheim
/server action:stop server:valheim.myvalheim  
/server action:restart server:valheim.myvalheim
/server action:info server:valheim.myvalheim

Using Server Interface

In a channel named valheim-myvalheim, use:

/peon

This gives you server-specific controls:

🚀 Start - Boot up the server
🛑 Stop - Shutdown server (with optional timer)
🔄 Restart - Quick restart
📊 Info - View server status
⬆️ Update - Update game files
📦 Backup - Download server backup

Step 7: Connect to Your Server

Find Server Details

Use the info command to get connection details:

/server action:info server:valheim.myvalheim

This shows: - Server IP: Your host IP address - Port: Assigned port (e.g., 2456) - Status: Running/Stopped - Players: Current player count

Connect from Game Client

Example for Valheim: 1. Open Valheim 2. Go to "Join Game" → "Add server" 3. Enter: your-server-ip:2456 4. Connect and enjoy!

Common Server Operations

Scheduled Server Stops

Stop server in 30 minutes:

/server action:stop server:valheim.myvalheim timer:30m

Stop at specific time:

/server action:stop server:valheim.myvalheim timer:22:00

Server Updates

Update game files:

/server action:update server:valheim.myvalheim mode:server

Full container update:

/server action:update server:valheim.myvalheim mode:full

Backups

Create and download backup:

/server action:backup server:valheim.myvalheim

Next Steps

Create More Servers

You can run multiple servers of the same or different games:

/create minecraft survival-world
/create palworld pals-paradise  
/create ark dino-island

Organize with Channels

Create dedicated Discord channels for each server: - #valheim-myvalheim - #minecraft-survival-world - #palworld-pals-paradise