Skip to content

Add Docmost v0.25.3 - Collaborative Wiki and Documentation Platform#38

Open
BookJJun-IJ wants to merge 4 commits intoYundera:mainfrom
BookJJun-IJ:Docmost
Open

Add Docmost v0.25.3 - Collaborative Wiki and Documentation Platform#38
BookJJun-IJ wants to merge 4 commits intoYundera:mainfrom
BookJJun-IJ:Docmost

Conversation

@BookJJun-IJ
Copy link
Member

Add Docmost v0.25.3 - Collaborative Wiki and Documentation Platform

Description

Docmost is an open-source, self-hosted wiki and documentation tool — a modern alternative to Confluence and Notion. Create, collaborate, and share knowledge with your team in real-time.

Key Features:

  • Real-time collaborative editing with rich text editor
  • Spaces and pages for organized documentation
  • Permissions and roles for team access control
  • Nested pages with drag-and-drop organization
  • Full-text search across all documents
  • File attachments and image embedding
  • Comments and discussions on pages
  • Page history and version tracking

Technical Implementation:

  • 3-container architecture: Docmost + PostgreSQL 16 + Redis 7.2
  • $PCS_DEFAULT_PASSWORD for database authentication and APP_SECRET (no hardcoded credentials)
  • Caddy reverse proxy labels for clean HTTPS URLs
  • Port 80 exposed for clean NSL Router URLs
  • Healthcheck on PostgreSQL with service_healthy dependency condition
  • Internal docmost-network for inter-service communication + external pcs for routing
  • Multi-language support (English, Korean, Chinese, Spanish, French)

Architecture:

User → Caddy (HTTPS) → Docmost (port 80) → PostgreSQL (data) + Redis (cache/sessions)

Security Checklist

  • Authentication via onboarding - first user becomes workspace admin (valid exception per CONTRIBUTING.md)
  • No hardcoded credentials - $PCS_DEFAULT_PASSWORD for database and APP_SECRET
  • Proper file permissions: user: "0:0" on all services (AppData-only access)
  • Specific version tags: docmost/docmost:0.25.3, postgres:16-alpine, redis:7.2-alpine

Functionality Checklist

  • Works immediately after installation - onboarding starts automatically
  • Data mapped to /DATA/AppData/$AppID/ (pgdata, redis, storage)
  • No manual configuration required - DB auto-initialized, workspace created via onboarding
  • Data persistence - all documents, user accounts, and attachments persist across reinstalls
  • cpu_shares set on all services:
    • docmost: 70 (Interactive with Heavy Tasks - real-time collaborative editor + WebSocket)
    • docmost-db: 50 (Standard Application - PostgreSQL backend)
    • docmost-redis: 30 (Background Service - cache and session store)
  • Resource limits and reservations configured:
    • docmost: 1G limit / 512M reservation
    • docmost-db: 512M limit / 256M reservation
    • docmost-redis: 256M limit / 128M reservation
  • Healthcheck on PostgreSQL with proper start_period
  • depends_on with condition: service_healthy (db) and service_started (redis) ensures correct startup order
  • Fresh installation tested
  • Uninstall/reinstall tested - data persists

Documentation Checklist

  • Clear description in 5 languages (en_us, ko_kr, zh_cn, fr_fr, es_es)
  • Multi-language taglines
  • Multi-language tips with setup instructions
  • Icon, screenshots point to BookJJun-IJ/AppStore@create

Testing

  • ✅ Fresh installation - all 3 containers start in correct order
  • ✅ Healthcheck passes for PostgreSQL
  • ✅ Database auto-creation and migration successful
  • ✅ Workspace admin account creation via onboarding flow
  • ✅ Real-time collaborative editing functional
  • ✅ Page creation, nested pages, and spaces working
  • ✅ File attachments and image embedding working
  • ✅ Full-text search functional
  • ✅ Data persistence across uninstall/reinstall
  • ✅ Resource usage within configured limits

Category

Documents

Screenshots

  1. Real-time collaborative editing with your team
  2. Organized knowledge with spaces and nested pages
  3. Open-source wiki platform with full data ownership

Links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant