Skip to content

Latest commit

 

History

History
71 lines (44 loc) · 3.42 KB

README.md

File metadata and controls

71 lines (44 loc) · 3.42 KB

Draw.io integration for Nextcloud

GitHub release License: AGPL v3 Nextcloud

Create and edit draw.io diagrams and whiteboards directly within Nextcloud. Note that draw.io is NOT open source software.

Install from the Nextcloud App Store

Features

  • Diagrams & Whiteboards — create .drawio diagrams and .dwb whiteboards from the "New file" menu
  • Real-time collaboration — multiple users can edit the same diagram simultaneously
  • Dark mode — automatic or manual dark theme support
  • Diagram previews — PNG thumbnails displayed in the Nextcloud file list
  • Public sharing — view or edit diagrams via Nextcloud share links, including password-protected links
  • File versioning — access and restore previous diagram revisions
  • Self-hosting — use your own draw.io server instead of the official one
  • Offline mode — work without an internet connection
  • Multilingual — translated into 99 languages
  • Admin controls — configure theme, language, autosave, custom libraries, and more

Requirements

Installation

  1. Copy the drawio directory to your Nextcloud server's /apps/ directory (or install from the App Store)
  2. Go to Apps > + Apps > Not Enabled and enable the Draw.io application
  3. Go to Admin settings > Draw.io and click Save to register MIME types

Real-time Collaboration

Real-time collaboration requires Autosave enabled and the official diagrams.net server (https://embed.diagrams.net). Self-hosted draw.io servers do not support real-time collaboration.

Configuration

Go to Admin settings > Draw.io to configure:

Available settings: draw.io server URL, theme, dark mode, language, autosave, custom libraries, offline mode, diagram previews, and editor configuration JSON.

If you would like to self-host draw.io, see docker-drawio (requires version 20.8.6+).

Known Issues

  • If you experience problems while updating Nextcloud, try disabling/removing the draw.io app (/apps/drawio/) and reinstalling it after the update completes.
  • Clear the PHP cache after updating the app if you get undefined method/class errors. For PHP-FPM: service php-fpm restart.
  • The Nextcloud integrity check may report a failure because the app registers custom MIME types and icons. This is expected and safe to ignore (#26).

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Changelog

See CHANGELOG.md for the full release history.

Support and SOC 2

This repo is not covered by the JGraph SOC 2 process. We do not provide commercial services or support for this app.

License

AGPL-3.0 — see LICENSE.