Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/wikioasis/salt/llms.txt

Use this file to discover all available pages before exploring further.

WikiOasis Salt is the production SaltStack configuration repository that manages every server in the WikiOasis wiki farm. It covers the full infrastructure stack: MediaWiki application servers, HAProxy load balancers, MariaDB databases, Redis caches, OpenSearch clusters, and a complete Icinga2 + Prometheus + Grafana monitoring setup — all expressed as declarative Salt states and pillar data.

Introduction

Learn what WikiOasis Salt is, how it is structured, and the conventions used throughout the repository.

Quickstart

Clone the repo, configure your private pillar, and apply your first state in minutes.

Architecture

Understand the server roles, network topology, and how states map to minion targets.

Configuration

Learn how pillar data drives every service — from MariaDB tuning to HAProxy backends.

What’s Managed

MediaWiki

Deployment tooling, jobrunner, and proxy configuration for the wiki application tier.

HAProxy

Load balancing with runtime route management — no reload required for routing changes.

MariaDB

Database servers with automated full, incremental, and binlog streaming backups.

Monitoring

Icinga2, Grafana, and Prometheus stack fully bootstrapped and configured via Salt.

OpenSearch

Full-text search cluster for MediaWiki CirrusSearch integration.

Salt Modules

Custom execution modules for HAProxy runtime control and Icinga2 downtime scheduling.

Quick Navigation

mwdeploy Reference

Complete reference for the MediaWiki deployment CLI, including flags, phases, and the TUI dashboard.

Adding a Server

Step-by-step runbook for registering a new minion and applying the correct role states.

Database Backup

How the backup state works, backup schedules, and how to verify or restore from a backup.

Top Files

How salt/top.sls and pillar/top.sls map minion IDs to states and pillar data.

Build docs developers (and LLMs) love