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:
@@ -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...
|
||||
|
||||
@@ -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] ==========================================
|
||||
|
||||
@@ -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!"
|
||||
83
automation/queue/document-wikijs-deployment.sh
Executable file
83
automation/queue/document-wikijs-deployment.sh
Executable 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!"
|
||||
3
automation/results/document-wikijs-deployment_result.txt
Normal file
3
automation/results/document-wikijs-deployment_result.txt
Normal 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
62
docs/wikijs-deployment.md
Normal 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** 🔥❄️
|
||||
Reference in New Issue
Block a user