Infrastructure Documentation

This repository contains documentation for the hosted services, physical nodes, infrastructure configuration, and operational procedures.

The documentation reflects the current deployed environment and the intended long-term organization of this repository. Documents marked with (planned) are intended to be created but do not currently exist.

The documentation should be updated when significant changes are made.

Public Services

The infrastructure documented in this repository supports public services available through:

• https://www.gorgarath.net

Documentation Scope

This documentation covers:

• Physical hosts and their capabilities.
• Pterodactyl deployments.
• Hosted game servers.
• Storage configuration.
• Network configuration.
• Operational procedures.
• Supporting services.

Infrastructure changes should be documented in the appropriate location:

• Hardware changes → nodes/
• Hosted server changes → servers/
• Shared infrastructure changes → infrastructure.md or services/
• New reusable document formats → templates/

Documentation Principles

• Never store passwords, API keys, tokens, private keys, or other sensitive credentials in documentation. Use an appropriate secrets management solution instead.
• Document the current configuration rather than historical configurations.
• Record the reasoning behind significant decisions.
• Update documentation whenever configuration changes are made.
• Keep infrastructure, node, server, and service documentation separated by responsibility.
• Document each component in the location where its configuration is managed.
• Prefer relative paths and repository-based references so documentation can be moved between local storage, Git, or web hosting without requiring major changes.

File Naming Conventions

• Use lowercase filenames.
• Use hyphens to separate words.
• Use .md for Markdown documentation files.
• Use directories to define document categories.
• Use *(planned)* for documents that are intended but not yet created.

Directory Structure

Document Index

Infrastructure

Nodes

Nodes are listed by operational importance rather than alphabetical order.

Servers

Individual server documentation is stored in per-server subdirectories under servers/.

Example:

servers/<server-name>/

Expected documentation files within each server directory:

Some servers may contain additional documents or may not require all of these files.

Services

The services/ directory is reserved for shared services that support the infrastructure.

Services should be documented separately from physical nodes and individual servers.

Planned documentation may include:

Templates

The templates/ directory contains templates for creating new documentation files.

Current templates:

Change History

2026-08-04

• Added a Public Services section with a reference to the public website.
• Updated documentation wording to clarify planned document markers.

2026-08-03

• Expanded the server documentation index to reflect the current documentation structure.
• Standardized document names and planned documentation entries.
• Added the server configuration template and updated template references.

2026-08-03

Refined the documentation index to better define repository organization, improve navigation, clarify documentation conventions, and add planned documentation entries for future server and service documentation.

2026-08-02

Updated the documentation index to better reflect the repository structure, server documentation conventions, and planned migration to Git.

2026-07-26

Documentation structure updated to separate infrastructure, nodes, servers, services, and templates.

This layout is intended to support future migration to Git or web-based documentation hosting.