Self-host excalidraw
v0.18.1Open-source virtual whiteboard for hand-drawn diagrams
- Stars
- 135 765
- Port
- 80 (HTTP web server for Excalidraw client)
excalidraw/excalidrawWhat is excalidraw?
Excalidraw is an open-source virtual whiteboard application for sketching hand-drawn style diagrams, wireframes, and illustrations. It provides an infinite canvas with tools for rectangles, circles, arrows, free-draw, and more. The editor supports dark mode, image embedding, shape libraries, localization, and exports to PNG, SVG, clipboard, and its own .excalidraw JSON format. The core npm package (@excalidraw/excalidraw) can be embedded in other React applications. For self-hosting, a Docker image (excalidraw/excalidraw) serves the client on port 80; the hosted excalidraw.com adds real-time collaboration and end-to-end encryption via a separate collab server (excalidraw-room), which is not included in the self-hosted Docker image. The project is MIT-licensed and maintained by the Excalidraw organization.
excalidraw alternatives
excalidraw-persistExcalidraw Persist is a self-hosted, open-source whiteboard based on Excalidraw that adds server-side persistence, multiple boards, and trash recovery using SQLite.Compareexcalidraw-persist with excalidraw
excalidraw-yjs-starterSelf-hosted collaborative whiteboard using Excalidraw, Next.js, YJS, and Socket.IO with MongoDB and MinIO.Compareexcalidraw-yjs-starter with excalidraw
excalidraw-self-hostedDocker Compose configuration for self-hosted Excalidraw with real-time collaboration, MongoDB storage, and Traefik reverse proxy.Compareexcalidraw-self-hosted with excalidraw
whiteboardCollaborative whiteboard with NodeJS. Real-time drawing, cursor visibility, per-user undo/redo, image/PDF drag-drop, REST API control, Nextcloud WebDAV integration.Comparewhiteboard with excalidraw
DrawnixSelf-hosted, open-source all-in-one whiteboard with mind maps, flowcharts and freehand drawing, built on the Plait framework.CompareDrawnix with excalidraw
draw.iodraw.io is a JavaScript, client-side editor for general diagramming.Comparedraw.io with excalidraw
WBOSelf-hosted, open-source collaborative whiteboard where many people draw together in real time; boards persist as SVG and it runs via Docker or Node.js.CompareWBO with excalidraw
pad.wsWhiteboard as an IDE, draw and code in your browserComparepad.ws with excalidraw
Should you self-host excalidraw?
excalidraw scores 90/100 on selfhost.directory (how scoring works) and ranks #1 of 9 in Whiteboarding. It has 135 765 GitHub stars, +2 026 in the last 30 days.
It shipped 1 stable release in the past year. The latest, v0.18.1, came out on 21 April 2026.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is WBO (61/100, 2 685 stars). excalidraw scores higher overall. See excalidraw vs WBO side by side.
Features
- Arrow binding & labeled arrows
- Drawing Tools
- Export to PNG/SVG/clipboard
- Hand-drawn style
- Image Support
- Infinite canvas
- Local-first autosaveBrowser storage can be cleared; file export recommended
- Localization (i18n)
- Real-Time CollaborationRequires separate excalidraw-room server; not included in self-hosted Docker image
- Shape libraries
- Undo/Redo
- Zoom and pan
excalidraw README
The Excalidraw editor (npm package) supports:
- 💯 Free & open-source.
- 🎨 Infinite, canvas-based whiteboard.
- ✍️ Hand-drawn like style.
- 🌓 Dark mode.
- 🏗️ Customizable.
- 📷 Image support.
- 😀 Shape libraries support.
- 🌐 Localization (i18n) support.
- 🖼️ Export to PNG, SVG & clipboard.
- 💾 Open format - export drawings as an
.excalidrawjson file. - ⚒️ Wide range of tools - rectangle, circle, diamond, arrow, line, free-draw, eraser...
- ➡️ Arrow-binding & labeled arrows.
- 🔙 Undo / Redo.
- 🔍 Zoom and panning support.
The app hosted at excalidraw.com is a minimal showcase of what you can build with Excalidraw. Its source code is part of this repository as well, and the app features:
- 📡 PWA support (works offline).
- 🤼 Real-time collaboration.
- 🔒 End-to-end encryption.
- 💾 Local-first support (autosaves to the browser).
- 🔗 Shareable links (export to a readonly link you can share with others).
We'll be adding these features as drop-in plugins for the npm package in the future.
Note: following instructions are for installing the Excalidraw npm package when integrating Excalidraw into your own app. To run the repository locally for development, please refer to our Development Guide.
Use npm or yarn to install the package.
npm install react react-dom @excalidraw/excalidraw
# or
yarn add react react-dom @excalidraw/excalidrawCheck out our documentation for more details!
- Missing something or found a bug? Report here.
- Want to contribute? Check out our contribution guide or let us know on Discord.
- Want to help with translations? See the translation guide.
Google Cloud • Meta • CodeSandbox • Obsidian Excalidraw • Replit • Slite • Notion • HackerRank • and many others
If you like the project, you can become a sponsor at Open Collective or use Excalidraw+.
Last but not least, we're thankful to these companies for offering their services for free:
FAQ
How to fix text rendering issues in Brave browser?
Disable 'Aggressively Block Fingerprinting' in Brave Shields settings for excalidraw.com, which breaks the measureText API used for text elements.
More in Whiteboarding
excalidraw-persistExcalidraw Persist is a self-hosted, open-source whiteboard based on Excalidraw that adds server-side persistence, multiple boards, and trash recovery using SQLite.
excalidraw-self-hostedDocker Compose configuration for self-hosted Excalidraw with real-time collaboration, MongoDB storage, and Traefik reverse proxy.
IdeonIdeon is a self-hosted, open-source visual workspace where notes, links, files and Git repos share one infinite canvas, with real-time multiplayer and Git sync.
spacedeck-openSpacedeck Open is a self-hosted, open-source collaborative whiteboard for real-time teamwork with drag-and-drop media, drawing tools, and presentation mode.
tableaunoirA self-hosted whiteboard for teachers featuring movable magnets to animate lessons, real-time collaboration, LaTeX math, and offline desktop use.
WBOSelf-hosted, open-source collaborative whiteboard where many people draw together in real time; boards persist as SVG and it runs via Docker or Node.js.
DigiboardSelf-hosted, open-source collaborative whiteboard for classes and remote teams, with drawing tools, colored labels, pinned comments, multi-page boards and PNG export.
DigiscreenSelf-hosted open-source classroom background from La Digitale: combine QR codes, drawing, YouTube, timers, word clouds, TTS and exercises into .dgs boards.
drafft-inkA self-hosted, open-source whiteboard with an infinite canvas, real-time CRDT collaboration, and WebGPU rendering — no accounts or subscriptions needed.
draw.iodraw.io is a JavaScript, client-side editor for general diagramming.
DrawnixSelf-hosted, open-source all-in-one whiteboard with mind maps, flowcharts and freehand drawing, built on the Plait framework.
ExcaliDashExcaliDash is a self-hosted, open-source Excalidraw workspace adding collections, real-time collaboration, version history, and backups with local or OIDC auth.

0 comments