Lemontropia-Suite/docs/WikiJS-Setup-Guide.md

Self-Hosted Obsidian Alternative: Wiki.js

This guide sets up Wiki.js as your always-on documentation vault that syncs with your existing workflow.

What is Wiki.js?

• Web-based Obsidian alternative (always accessible)
• Markdown native (same format as Obsidian)
• Git sync (integrates with your Gitea!)
• Self-hosted in Docker via Portainer
• FREE and open source

Why Wiki.js over other options?

Feature	Wiki.js	Obsidian Publish	Other Wikis
Self-hosted	✅ Yes	❌ No	Varies
Markdown	✅ Native	✅ Yes	⚠️ Partial
Git sync	✅ Yes	❌ No	❌ Rare
Web editing	✅ Yes	✅ Yes	✅ Yes
Free	✅ Yes	❌ $8/mo	Varies
Gitea integration	✅ Yes	❌ No	❌ No

Prerequisites

• Docker VM with Portainer running
• At least 2GB RAM available
• (Optional) Gitea repository for sync

---

Setup Instructions

Step 1: Create the Stack in Portainer

1. Open Portainer (http://your-docker-vm:9000)
2. Go to Stacks → Add stack
3. Name: wikijs-vault
4. Build method: Web editor
5. Copy-paste the YAML below:

version: '3.8'

services:
  wikidb:
    image: postgres:15-alpine
    container_name: wikijs-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    volumes:
      - wikijs-db-data:/var/lib/postgresql/data
    networks:
      - wikijs-network

  wiki:
    image: ghcr.io/requarks/wiki:2
    container_name: wikijs
    restart: unless-stopped
    depends_on:
      - wikidb
    environment:
      DB_TYPE: postgres
      DB_HOST: wikidb
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    ports:
      - "3001:3000"
    volumes:
      - wikijs-data:/wiki/data
    networks:
      - wikijs-network

networks:
  wikijs-network:

volumes:
  wikijs-db-data:
  wikijs-data:

6. Click "Deploy the stack"

Step 2: Initial Setup (2 minutes)

1. Wait 30 seconds for containers to start
2. Open Wiki.js: http://your-docker-vm-ip:3001
3. Create admin account
4. Choose "Local" authentication (or LDAP if you have it)

Step 3: Configure Git Sync (Connect to Gitea)

This syncs your wiki with a Git repository (bidirectional!)

1. In Wiki.js: Administration → Git → Enable
2. Set these values:
   • Git URL: http://192.168.5.30:3000/impulsivefps/lemontropia-wiki.git
   • Branch: main
   • Username: impulsivefps
   • Password/Token: Your Gitea token
   • Sync Direction: Bidirectional
3. Click "Apply"

Step 4: Create Gitea Repository

1. Open Gitea (http://192.168.5.30:3000)
2. New Repository:
   • Name: lemontropia-wiki
   • Description: "Lemontropia Suite Documentation"
   • Private: Yes
3. Generate token in Gitea settings for Wiki.js

---

Using Your Wiki

From Browser (Anywhere)

• URL: http://your-docker-vm:3001
• Edit directly in web interface
• Markdown support with live preview
• Search across all content

From Obsidian Desktop

1. Clone the repo: git clone http://192.168.5.30:3000/impulsivefps/lemontropia-wiki.git
2. Open folder as vault in Obsidian
3. Edit normally
4. Sync: Git commit → Auto-syncs to Wiki.js!

Best of Both Worlds

• Quick edits → Use web interface (always available)
• Heavy writing → Use Obsidian desktop + git
• Mobile access → Web interface works on phone/tablet
• Offline work → Obsidian desktop works offline, sync later

---

Integration with Lemontropia Suite

Your app can now:

1. Write to Obsidian vault locally
2. Git commit/push → Syncs to Gitea
3. Wiki.js pulls → Documentation live on web
4. Access anywhere → http://docker-vm:3001

---

Backup Strategy

Wiki.js data is stored in:

• Docker volumes (auto-backed up with VM)
• Git repository (in Gitea, already backed up)

Your docs are safe! 🎉

---

Troubleshooting

Can't access on port 3001?

Check firewall: sudo ufw allow 3001/tcp

Git sync not working?

• Verify Gitea token has "repo" permissions
• Check URL format (http vs https)
• Review Wiki.js logs in Portainer

Obsidian sync conflicts?

• Always pull before editing in Obsidian
• Use "Sync" button in Wiki.js before web edits

---

Questions? The Lemontropia Suite docs will live here! 🍋📚