Add infrastructure overview and service documentation

README.md

@@ -1,16 +1,41 @@
-# SilverLinux
+# SilverLinux Infrastructure
 
-Production infrastructure for Silver Solutions.
+This repository contains the infrastructure configuration and documentation for the SilverLinux server.
 
 ## Services
 
-- Nginx Proxy Manager
+### Running
-- Portainer
+
-- PostgreSQL
+* Gitea
-- Gitea
+* Portainer
+* Nginx Reverse Proxy
+
+### Planned
+
+* BaGet
+* Plane.so
+
+## Purpose
+
+This repository serves as the single source of truth for rebuilding and maintaining the SilverLinux environment.
+
+Infrastructure documentation, Docker Compose files, reverse proxy configuration, backup procedures, and deployment notes are stored here.
 
 ## Server
 
-- Ubuntu 24.04
+* Hostname: silverlinux
-- Docker 29
+* OS: Ubuntu Server 24.04 LTS
-- RAID1
+* Provider: OVH
+
+## Important
+
+Do not commit:
+
+* Passwords
+* API Keys
+* SMTP Credentials
+* SSL Private Keys
+* Database Credentials
+* Real `.env` files
+
+Use `.env.example` files instead.

SUMMARY.md

@@ -0,0 +1,214 @@
+# SilverLinux Infrastructure Summary
+
+Last Updated: 2026-06-21
+
+## Overview
+
+SilverLinux is the primary self-hosted infrastructure server for Silver Solutions.
+
+The server hosts development and collaboration services used for software development, source control, package management, project management and future CI/CD automation.
+
+## Server Information
+
+### Host
+
+| Property         | Value                   |
+| ---------------- | ----------------------- |
+| Name             | SilverLinux             |
+| Provider         | OVH                     |
+| Operating System | Ubuntu Server 24.04 LTS |
+| Public IP        | 51.255.83.140           |
+
+### Hardware
+
+| Resource | Value               |
+| -------- | ------------------- |
+| CPU      | Intel Xeon-D 1520   |
+| Memory   | 32 GB RAM           |
+| Storage  | 2 × 480 GB SSD RAID |
+
+---
+
+## Security
+
+### SSH
+
+* SSH key authentication enabled
+* Root login disabled
+
+### Firewall
+
+* UFW enabled
+
+### Protection
+
+* Fail2Ban enabled
+
+---
+
+## Container Platform
+
+### Docker
+
+All application services are deployed using Docker containers.
+
+### Docker Compose
+
+Docker Compose is used for service deployment and management.
+
+---
+
+## Running Services
+
+### Gitea
+
+Purpose:
+
+* Source control
+* Pull requests
+* Issue tracking
+* Git hosting
+
+URL:
+
+```text
+https://git.silveressence.net
+```
+
+Authentication:
+
+* Local accounts
+
+Future considerations:
+
+* Google OAuth
+* GitHub OAuth
+
+Current focus:
+
+* Disable OpenID
+* Enable 2FA
+* Configure backups
+
+---
+
+### Portainer
+
+Purpose:
+
+* Docker management
+* Container monitoring
+* Stack deployment
+
+URL:
+
+```text
+https://portainer.silveressence.net
+```
+
+---
+
+### Nginx
+
+Purpose:
+
+* Reverse proxy
+* SSL termination
+* Domain routing
+
+---
+
+## Email
+
+Sender address:
+
+```text
+noreply@silveressence.net
+```
+
+Purpose:
+
+* Password reset emails
+* Service notifications
+* Future CI/CD notifications
+
+---
+
+## Domains
+
+| Domain                      | Purpose      |
+| --------------------------- | ------------ |
+| git.silveressence.net       | Gitea        |
+| portainer.silveressence.net | Portainer    |
+| nuget.silveressence.net     | Future BaGet |
+| plane.silveressence.net     | Future Plane |
+
+---
+
+## Planned Services
+
+### BaGet
+
+Purpose:
+
+* Private NuGet package hosting
+
+Status:
+
+* Planned
+
+### Plane.so
+
+Purpose:
+
+* Project management
+* Sprint planning
+* Issue tracking
+
+Status:
+
+* Planned
+
+---
+
+## Backup Priorities
+
+Critical data:
+
+* Gitea repositories
+* Gitea database
+* Gitea configuration
+* Docker Compose files
+* Nginx configuration
+* SSL certificates
+
+---
+
+## Future Roadmap
+
+### Phase 1
+
+* Verify email configuration
+* Disable OpenID
+* Enable Gitea 2FA
+* Configure backups
+
+### Phase 2
+
+* Deploy BaGet
+* Configure private package feeds
+
+### Phase 3
+
+* Deploy Plane.so
+
+### Phase 4
+
+* Implement CI/CD pipelines
+* Deploy directly from Gitea to IIS servers
+
+---
+
+## Mission
+
+Provide a reliable, secure and self-hosted platform for development, deployment and collaboration within Silver Solutions.

docs/services.md

@@ -0,0 +1,150 @@
+# Services
+
+## Running Services
+
+### Gitea
+
+URL:
+
+```text
+https://git.silveressence.net
+```
+
+Purpose:
+
+* Git repositories
+* Pull requests
+* Source control
+
+Status:
+
+* Running
+
+---
+
+### Portainer
+
+URL:
+
+```text
+https://portainer.silveressence.net
+```
+
+Purpose:
+
+* Docker administration
+* Stack deployment
+
+Status:
+
+* Running
+
+---
+
+### Nginx
+
+Purpose:
+
+* Reverse proxy
+* SSL termination
+
+Status:
+
+* Running
+
+## Planned Services
+
+### BaGet
+
+Purpose:
+
+* Private NuGet feed
+
+Status:
+
+* Planned
+
+### Plane.so
+
+Purpose:
+
+* Project management
+
+Status:
+
+* Planned
+# Services
+
+## Running Services
+
+### Gitea
+
+URL:
+
+```text
+https://git.silveressence.net
+```
+
+Purpose:
+
+* Git repositories
+* Pull requests
+* Source control
+
+Status:
+
+* Running
+
+---
+
+### Portainer
+
+URL:
+
+```text
+https://portainer.silveressence.net
+```
+
+Purpose:
+
+* Docker administration
+* Stack deployment
+
+Status:
+
+* Running
+
+---
+
+### Nginx
+
+Purpose:
+
+* Reverse proxy
+* SSL termination
+
+Status:
+
+* Running
+
+## Planned Services
+
+### BaGet
+
+Purpose:
+
+* Private NuGet feed
+
+Status:
+
+* Planned
+
+### Plane.so
+
+Purpose:
+
+* Project management
+
+Status:
+
+* Planned