From efbdfb241cc93bae42d9f60d1c7cca4f1c686cd2 Mon Sep 17 00:00:00 2001
From: Saeed Asgari <oclick021@gmail.com>
Date: Sun, 21 Jun 2026 12:08:02 +0330
Subject: [PATCH] Add infrastructure overview and service documentation

---
 SUMMARY.md       | 214 +++++++++++++++++++++++++++++++++++++++++++++++
 docs/services.md | 150 +++++++++++++++++++++++++++++++++
 2 files changed, 364 insertions(+)

diff --git a/SUMMARY.md b/SUMMARY.md
index e69de29..956b7a8 100644
--- a/SUMMARY.md
+++ b/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.
diff --git a/docs/services.md b/docs/services.md
index e69de29..7ea7213 100644
--- a/docs/services.md
+++ b/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