Wiki.js dual deployment complete - subscribers + staff

Services 5 & 6 of 7 deployed on Ghost VPS.
Phase 0.5: 86% complete (6/7 services operational)
This commit is contained in:
Firefrost Automation
2026-02-09 21:23:41 -06:00
parent 8beb8ea2cc
commit 75a95ebde9
6 changed files with 156 additions and 179 deletions

View File

@@ -126,3 +126,4 @@
[2026-02-09 20:27:47] DAEMON: Found 1 task(s) in queue - executing...
[2026-02-09 20:33:54] DAEMON: Found 1 task(s) in queue - executing...
[2026-02-09 21:06:45] DAEMON: Found 1 task(s) in queue - executing...
[2026-02-09 21:23:41] DAEMON: Found 1 task(s) in queue - executing...

View File

@@ -579,3 +579,10 @@
[2026-02-09 21:06:45] ==========================================
[2026-02-09 21:06:46] Executing task: document-mkdocs-deployment.sh
[2026-02-09 21:06:46] ==========================================
[2026-02-09 21:06:46] Task document-mkdocs-deployment.sh completed (exit code: 0)
[2026-02-09 21:06:46] Committing results to Git...
[2026-02-09 21:06:46] Executor run complete
[2026-02-09 21:23:41] Pulling latest from Git...
[2026-02-09 21:23:41] ==========================================
[2026-02-09 21:23:41] Executing task: document-wikijs-deployment.sh
[2026-02-09 21:23:41] ==========================================

View File

@@ -1,179 +0,0 @@
#!/bin/bash
cd ~/firefrost-work/firefrost-operations-manual
# Create MkDocs deployment documentation
cat > docs/mkdocs-deployment.md << 'DOC'
# MkDocs Deployment - docs.firefrostgaming.com
**Date:** February 9, 2026
**Server:** Ghost VPS (64.50.188.14)
**Status:** ✅ OPERATIONAL
**Service:** 4/7 (Phase 0.5: 57% complete)
---
## Deployment Summary
**Duration:** ~20 minutes
**Components Installed:**
- MkDocs 1.6.1
- Material Theme 9.7.1
- Python 3.12.3
- Certbot (Let's Encrypt)
**URLs:**
- Production: https://docs.firefrostgaming.com
- Local: /var/www/mkdocs/docs-site
---
## Installation Steps
1. **Python & Dependencies**
```bash
apt update && apt install -y python3-pip python3-venv
pip3 install mkdocs mkdocs-material --break-system-packages
```
2. **Site Creation**
```bash
mkdir -p /var/www/mkdocs
cd /var/www/mkdocs
mkdocs new docs-site
```
3. **Theme Configuration**
- Theme: Material (slate scheme)
- Colors: Firefrost brand (cyan primary, deep orange accent)
- Features: Navigation tabs, search, TOC integration
- Custom CSS: /docs/stylesheets/extra.css
4. **Content Created**
- Home page (Fire + Frost branding)
- Getting Started guide
- Server Rules
5. **Build**
```bash
cd docs-site
mkdocs build --clean
```
6. **Nginx Configuration**
- Site: /etc/nginx/sites-available/docs.firefrostgaming.com
- Root: /var/www/mkdocs/docs-site/site
- Security headers enabled
7. **SSL Certificate**
- Provider: Let's Encrypt
- Expires: May 11, 2026
- Verify return code: 0 (ok)
- Auto-renewal: Configured
---
## Verification Tests
✅ HTTP → HTTPS redirect working
✅ HTTPS serving correctly (HTTP/2 200)
✅ SSL certificate valid (Verify return code: 0)
✅ Security headers active (X-Frame-Options, X-Content-Type-Options)
✅ DNS resolves to 64.50.188.14
✅ Nginx stable and running
✅ Brand colors applied (Frost theme)
✅ Visual enhancements added
---
## Brand Customization
**Colors Applied (Design Bible v1.1):**
- Primary: #00E5FF (Electric Cyan)
- Background: Dark slate
- Accent: #FF3D00 (Deep Orange/Red)
**Visual Enhancements:**
- Fire + Frost dual-column layout
- Emoji branding (🔥❄️)
- Color-coded path descriptions
- Call-to-action sections
---
## File Structure
```
/var/www/mkdocs/docs-site/
├── docs/
│ ├── index.md (Home with Fire+Frost branding)
│ ├── getting-started.md
│ ├── rules.md
│ └── stylesheets/
│ └── extra.css (Firefrost brand colors)
├── site/ (built HTML)
└── mkdocs.yml (configuration)
```
---
## Maintenance
**Update Content:**
```bash
cd /var/www/mkdocs/docs-site
# Edit files in docs/
mkdocs build --clean
```
**Add New Page:**
```bash
# Create docs/new-page.md
# Add to mkdocs.yml under nav:
mkdocs build --clean
```
---
## Known Issues
**Browser "Not secure" warning (Chrome-specific):**
- Server SSL is valid (Verify return code: 0)
- Certificate from Let's Encrypt is trusted
- Issue: Browser cache/extension interference
- Fix: Clear Chrome SSL cache (chrome://net-internals)
---
## Next Steps
- Integrate with Gitea (auto-build on commit)
- Add modpack-specific documentation
- Create subscriber-only content markers
- Link to Wiki.js for premium content
---
**Fire + Frost = Where Passion Meets Precision** 🔥❄️
DOC
# Update Infrastructure Manifest
sed -i 's/⏳ PENDING/✅ OPERATIONAL/' Firefrost_Infrastructure_Manifest.md
sed -i '/MkDocs.*Ghost VPS/s/⏳ PENDING/✅ OPERATIONAL/' Firefrost_Infrastructure_Manifest.md
# Update project-files copy
cp Firefrost_Infrastructure_Manifest.md project-files/Firefrost_Vanilla_Manifest.md
# Commit
git add -A
git commit -m "MkDocs deployment complete - docs.firefrostgaming.com
Service 4/7 deployed successfully on Ghost VPS.
- MkDocs 1.6.1 with Material theme
- Firefrost brand colors applied
- SSL certificate valid
- Public documentation live
Phase 0.5: 57% complete (4/7 services operational)"
git push
echo "MkDocs deployment documented and committed!"

View File

@@ -0,0 +1,83 @@
#!/bin/bash
cd ~/firefrost-work/firefrost-operations-manual
cat > docs/wikijs-deployment.md << 'DOC'
# Wiki.js Dual Deployment - Subscribers + Staff
**Date:** February 9, 2026
**Server:** Ghost VPS (64.50.188.14)
**Status:** ✅ OPERATIONAL
**Services:** 5 & 6 of 7 (Phase 0.5: 86% complete)
---
## Deployment Summary
**Duration:** ~30 minutes
**Instances Deployed:** 2 (Subscribers + Staff)
**URLs:**
- https://subscribers.firefrostgaming.com (port 3100)
- https://staff.firefrostgaming.com (port 3101)
**Components:**
- Wiki.js 2.5.311
- PostgreSQL (2 databases)
- Node.js 22.22.0
- Nginx reverse proxy
- SSL certificates (Let's Encrypt)
---
## Installation
1. **PostgreSQL Setup**
- Created 2 databases: wikijs_subscribers, wikijs_staff
- Created wikijs user with proper grants
- Fixed schema permissions (GRANT ALL ON SCHEMA public)
2. **Wiki.js Installation**
- Downloaded to /var/www/wikijs-subscribers
- Downloaded to /var/www/wikijs-staff
- Configured separate ports (3100, 3101)
3. **Configuration**
- HTTPS host URLs configured
- PostgreSQL connections
- Separate systemd services
4. **Nginx + SSL**
- Reverse proxy for both domains
- Single SSL certificate covering both
- Expires: May 11, 2026
---
## Verification
✅ Both services running
✅ HTTPS working (HTTP/2 200)
✅ SSL certificate valid
✅ Setup wizards accessible
✅ PostgreSQL connections stable
---
**Fire + Frost = Where Passion Meets Precision** 🔥❄️
DOC
# Update manifest
sed -i 's/Wiki.js (Sub).*Ghost VPS.*⏳ PENDING/Wiki.js (Sub) | Ghost VPS | 64.50.188.14 | subscribers.firefrostgaming.com | ✅ OPERATIONAL/' Firefrost_Infrastructure_Manifest.md
sed -i 's/Wiki.js (Staff).*Ghost VPS.*⏳ PENDING/Wiki.js (Staff) | Ghost VPS | 64.50.188.14 | staff.firefrostgaming.com | ✅ OPERATIONAL/' Firefrost_Infrastructure_Manifest.md
cp Firefrost_Infrastructure_Manifest.md project-files/Firefrost_Vanilla_Manifest.md
git add -A
git commit -m "Wiki.js dual deployment complete - subscribers + staff
Services 5 & 6 of 7 deployed on Ghost VPS.
Phase 0.5: 86% complete (6/7 services operational)"
git push
echo "Wiki.js documented and committed!"

View File

@@ -0,0 +1,3 @@
Task: document-wikijs-deployment.sh
Started: Mon Feb 9 21:23:41 CST 2026
==========================================

62
docs/wikijs-deployment.md Normal file
View File

@@ -0,0 +1,62 @@
# Wiki.js Dual Deployment - Subscribers + Staff
**Date:** February 9, 2026
**Server:** Ghost VPS (64.50.188.14)
**Status:** ✅ OPERATIONAL
**Services:** 5 & 6 of 7 (Phase 0.5: 86% complete)
---
## Deployment Summary
**Duration:** ~30 minutes
**Instances Deployed:** 2 (Subscribers + Staff)
**URLs:**
- https://subscribers.firefrostgaming.com (port 3100)
- https://staff.firefrostgaming.com (port 3101)
**Components:**
- Wiki.js 2.5.311
- PostgreSQL (2 databases)
- Node.js 22.22.0
- Nginx reverse proxy
- SSL certificates (Let's Encrypt)
---
## Installation
1. **PostgreSQL Setup**
- Created 2 databases: wikijs_subscribers, wikijs_staff
- Created wikijs user with proper grants
- Fixed schema permissions (GRANT ALL ON SCHEMA public)
2. **Wiki.js Installation**
- Downloaded to /var/www/wikijs-subscribers
- Downloaded to /var/www/wikijs-staff
- Configured separate ports (3100, 3101)
3. **Configuration**
- HTTPS host URLs configured
- PostgreSQL connections
- Separate systemd services
4. **Nginx + SSL**
- Reverse proxy for both domains
- Single SSL certificate covering both
- Expires: May 11, 2026
---
## Verification
✅ Both services running
✅ HTTPS working (HTTP/2 200)
✅ SSL certificate valid
✅ Setup wizards accessible
✅ PostgreSQL connections stable
---
**Fire + Frost = Where Passion Meets Precision** 🔥❄️