Skip to content

michaelstoffer/sietch-console

Repository files navigation

Sietch Console

The easiest way to self-host a Dune: Awakening battlegroup.

CI Release GitHub Release License: MIT Platform .NET 8 GitHub Sponsors

Sietch Console is a Windows-native desktop application that replaces the manual scripts, terminal windows, and raw INI editing required to host a Dune: Awakening dedicated server. It provides a single, modern UI for automated server download via SteamCMD, Hyper-V VM management, live server process control, log streaming, configuration, diagnostics, backups, and networking — designed for both non-technical players and advanced server hosts.


Features

Area What it does
Setup Wizard Guided multi-step onboarding — validates requirements, downloads server files via SteamCMD, configures the Hyper-V VM, and saves your battlegroup profile
Dashboard One-click Start / Stop / Restart with real Hyper-V VM control and server process management; live status, CPU/RAM display, update-available indicator, and one-click server update
Configuration Structured INI editor for server identity, gameplay settings, and network options; auto-backup before every save
Logs Live stdout/stderr stream from the running server process (with a LIVE badge) plus file-based tail; search, severity filtering, and detected-issue explanations
Diagnostics On-demand system readiness checks with friendly pass/warning/failure results and remediation guidance
Backups Config, save-data, and full (config + save-data) backups with full history, one-click restore, scheduled auto-backups, and configurable retention
Networking Host and VM IP detection (auto-persisted to profile), Windows Firewall rule checker and auto-creator, port forwarding guide, local port test, copyable connection summary
Settings Structured settings editor and raw INI editor with per-file selection
Multiple profiles Create, switch, and delete battleground profiles from the sidebar; all views update instantly when you switch
App Logs In-app viewer for Sietch Console's own log stream — filter by level or keyword to diagnose service issues without opening external files
Auto-Update On-startup check against GitHub Releases; banner notification when a new version is available; one-click download and install
Remote Management Embedded web dashboard accessible from any browser on the LAN — status, controls, and live log tail; REST + SSE API for custom integrations; Bearer token auth with rate limiting

Requirements

  • Windows 10 20H1 (build 19041) or Windows 11 — x64
  • Hyper-V enabled — requires Windows Pro, Enterprise, or Education edition
  • 8 GB RAM minimum (16 GB recommended when running the VM simultaneously)
  • .NET runtime — not required; the installer includes a self-contained runtime

Sietch Console manages a Dune: Awakening server running inside a Hyper-V virtual machine. The application does not run on Windows Home because Hyper-V is unavailable there.


Installation

Download the latest release from the Releases page.

Two options are available:

  • SietchConsole-<version>-Setup.exe — Windows installer with Start Menu and optional desktop shortcut
  • SietchConsole-<version>-win-x64-portable.zip — extract and run Sietch Console.exe from any folder

Full installation and first-launch instructions: INSTALL.md


Quick Start

  1. Install and launch Sietch Console.
  2. The Setup Wizard opens automatically on first launch.
  3. Work through each step — the wizard checks your system, downloads the Dune: Awakening server files via SteamCMD, configures your Hyper-V VM, and saves your battlegroup profile.
  4. Once setup is complete, use the Dashboard to start your server. The Logs tab shows live output; the Dashboard transitions to Running once the server is ready.
  5. Share your connection details from the Networking tab.

Architecture

Sietch Console (WPF .NET 8)
├── Views/              XAML views — one per navigation section
├── ViewModels/         CommunityToolkit.Mvvm ObservableObject classes
├── Services/           Application-layer services (Backups, Networking, …)
├── Converters/         IValueConverter implementations
└── Themes/             SietchTheme.xaml — global brushes, styles, templates

SietchConsole.Core
├── Models/             Sealed record types (domain objects)
└── Interfaces/         Service contracts (IBackupService, INetworkingService, …)

SietchConsole.Data
├── Entities/           EF Core entity classes
├── Repositories/       IRepository<T> implementations over SQLite
└── Migrations/         EF Core migration history

The application uses Microsoft.Extensions.Hosting for dependency injection and startup orchestration. All ViewModels are singletons; database repositories are scoped and accessed via IServiceScopeFactory.

Full architecture details: docs/architecture.md


Development Setup

Prerequisites

  • Windows 10/11 with Hyper-V enabled
  • .NET 8 SDK
  • Visual Studio 2022+ or JetBrains Rider
  • Git

Clone and build

git clone https://github.com/michaelstoffer/sietch-console.git
cd sietch-console
dotnet restore
dotnet build

Run

dotnet run --project "Sietch Console/Sietch Console.csproj"

Versioning The current version is set in Directory.Build.props. To release, update the version there, commit, and push a matching v*.*.* tag — GitHub Actions handles the rest.


Contributing

See CONTRIBUTING.md for branch naming, PR process, coding standards, and the milestone/issue workflow.


Disclaimer

Sietch Console is an unofficial community project. It is not affiliated with, endorsed by, or sponsored by Funcom.

Dune: Awakening and all related assets, trademarks, and intellectual property belong to their respective owners.


License

MIT — see LICENSE for details.

About

Sietch Console is a Windows-native server manager for self-hosted Dune: Awakening battlegroups. Built for non-technical players, it simplifies setup, configuration, updates, networking, backups, logs, and server management through a modern UI instead of raw scripts, terminals, and manual INI editing.

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors