# Dune: Awakening — Server Manager

## Virtual Machine

Unknown
State—
IP Address—
Memory—
Uptime—

VM failed to start — usually not enough free RAM on this PC. Lower memory and retry.

Startup memory

## Battlegroup

Unknown

    Waiting for status...

## SSH Key Problem

The manager cannot authenticate to the VM. Battlegroup commands will fail until this is fixed.

If you start the manager from WSL, prefer start_as_admin.bat on Windows after a reboot. You can also go to Settings → Rotate SSH Key while the VM is running.

## Battlegroup setup incomplete

The VM exists but the battlegroup was never fully installed (empty namespace). Enter your server token and run repair — this deletes the empty namespace and re-runs bootstrap.

World Name
Region
Server Token
Enable experimental swap memory

## Quick Links

File Browser
Director

## Initial Server Setup

Step 1 of 6

### Pre-flight Checks

Verifying your system is ready for the Dune: Awakening server.

☐ Hyper-V enabled and running
☐ Server files found (vmcx)
☐ Drive with 100GB+ free space
Existing installation detected

A Dune server VM is already on this machine. Delete everything and run setup again from scratch.

- Hyper-V VM `dune-awakening`
- `DuneAwakeningServer` folders on all drives
- SSH keys and saved VM credentials
- All in-VM battlegroup data (world, characters, configs)

This cannot be undone. Export a database backup first if you need your world data.

### VM Configuration

Choose where to install and how much resources to allocate.

Server Token Generate one at account.duneawakening.com
Install Drive
Memory
Network Mode
Network Adapter

### Installing

Importing VM, configuring network and memory, starting the virtual machine. This can take several minutes.

VM imported but failed to start — most likely not enough RAM. Reduce the memory and retry.

Memory

### Security

This will generate an SSH key, install it on the VM, and change the default password — all in one step.

Current VM Password Default is "dune" — change only if you've set it before
New Password
Confirm New Password

### Player Connectivity

Choose how the VM gets its IP and which IP players will connect to.

VM IP Assignment
Static IP
Gateway
Player-facing IP
Public IP (detecting...) Private IP Custom

### Finalize

Configure your world, then upload bootstrap files and run the first-time battlegroup setup. This is the final step.

World Name (max 50 chars)
Region
Enable experimental swap memory (recommended if memory < 20GB)

### Setup Complete

Your Dune: Awakening server is ready. Head to the Dashboard to start your battlegroup.

## Battlegroup Controls

Manage the lifecycle of your battlegroup. Start, stop, or restart game servers, and check for updates.

## Swap Memory

Enable experimental swap memory to significantly reduce RAM requirements per game server. Recommended if VM has less than 20GB allocated.

## Web Interfaces

Access the built-in web tools running inside the VM.

Open File Browser Open Director

## Log Export

Download logs from all battlegroup components or operator pods.

## Database Management

Back up or restore the battlegroup database. For best results, stop the battlegroup before performing these operations.

Editing characters directly modifies the game database. This may corrupt save data and cause total character loss. Always take a database backup before making changes. Only edit while the battlegroup is stopped and the player is logged out.

## Select Character

## Stats

Max Health
Tech Knowledge Points
Hydration
Heat Exhaustion
Current Spice
Spice Addiction Level
Spice Tolerance
Eyes of Ibad 0.0 – 1.0

## Inventory

0 items

Item | ID | Qty | Location |
--- | --- | --- | --- | ---

## Add Item

Item | Category | Qty | To |
--- | --- | --- | --- | ---

Type at least 2 characters to search by name or template ID across 1000 items.

## Tech Tree

—

Unlock or lock all recipes and blueprints in the tech knowledge tree. Unlock All merges every game recipe node into your save (not just ones already discovered). Stop the battlegroup and relog after changes.

## Specializations

Set XP and level for each specialization track, and unlock all keystones (perks) per tree.

### Unlock Keystones (Perks)

## Economy

Solari (Currency 0)
House Scrip (Currency 1)

## Faction Reputation

## Cosmetics & Skins

—

Search and unlock cosmetics by name. Vehicle Paints and Vehicle Variants are what show in the garage paint menu — not Swatch Tokens (those are inventory items; use Add Item instead).

Cosmetic | Category |
--- | --- | ---

Type at least 2 characters to search across 621 cosmetics, or pick a category filter.

Advanced: add by exact ID

## Game Configuration

Stop the battlegroup before editing. Changes require the battlegroup to be offline and will apply on next start.
Loading configuration...

## Server Visibility

Controls how players find your server. LAN = only players on your network. Public (WAN) = internet players (requires router port forwarding to your VM IP).

Self-hosted worlds appear in-game under Servers → Experimental (not Official or Private). Match the region you chose during setup.

Detecting IPs...
Custom IP

After changing visibility, stop the battlegroup completely, then start it again. The gateway reads this IP only at startup.

## PvP & Security

Force PvP on All Partitions
Security Zones Enabled

## Environment

Coriolis Storm
Sandstorm
Sandstorm Treasure Spawns

## Sandworm

Sandworm Enabled
Danger Zones Enabled
Sandworm Pushes Vehicles
Invulnerability on Vehicle Exit
sec
Invulnerability on Server Restart
sec

## Economy & Resources

Global Mining Multiplier
Vehicle Mining Multiplier
PvP Resource Multiplier
Item Decay Rate 0=off, 1-10
Vehicle Durability Damage 0=off, 1-10

## Building

Max Landclaim Segments
Blueprint Max Extensions
Base Backup Max Extensions
Building Restriction Limits

## Server

Server Display Name shown to players Shown in the in-game server browser. Leave empty only if you know your world display name from setup.
Server Login Password blank = no password
Game Port (starting)
IGW Port (starting)

## Change VM Password

Change the `dune` user password on the VM.

New Password
Confirm Password

## SSH Key

Generate a new SSH key pair and install it on the VM, replacing the current one.

## Experimental Features

Warning: Features on this tab are untested and may break your battlegroup. Always take a database backup before making changes. Use at your own risk.

## Multi-Sietch

Add additional sietches (Hagga Basin instances) to your battlegroup. All sietches share the same Overmap, Deep Desert, Arrakeen, Harkonnen Village, and instanced content (dungeons, story missions). Players from different sietches will see each other in shared areas but not in their respective Hagga Basin maps.

RAM Requirements

- Each sietch requires approximately 12 GB RAM
- Overmap + infrastructure (DB, RabbitMQ, K8s) uses ~6 GB
- 1 sietch: ~18 GB minimum (current default)
- 2 sietches: ~30 GB minimum
- 3 sietches: ~42 GB minimum

Port Forwarding

Each additional sietch adds one game server pod using host networking. Game ports auto-assign starting at UDP 7777. For N sietches you need ports 7777–7778+N (UDP) forwarded, plus the corresponding beacon ports. When in doubt, forward the full range 7777–7900 UDP.

Loading sietch info...

After adding or removing a sietch, restart the battlegroup for changes to take effect.

Working...