Your team's whiteboard, on your server. Self-hosted Excalidraw with accounts, folders, and search.
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/maciekzygmunt/excaliselfGuides for using mcp servers skills like excaliself.
See how excaliself compares with popular alternatives.
docker run --rm -p 127.0.0.1:3000:3000 -e PREVIEW_MODE=true ghcr.io/maciekzygmunt/excaliself
Open http://localhost:3000/preview/login to sign in as the admin, with example drawings. To test live collaboration, open http://localhost:3000/preview/login?account=new in a second browser: it signs in as a new member.
Data lives in memory and is gone when the container stops. For real use, see Deploy.
.excalidraw files (or .png/.svg exports with the scene) from your computer onto a folder in the sidebar.Each path runs the app next to its Postgres database and pulls the prebuilt
image ghcr.io/maciekzygmunt/excaliself (amd64 and arm64), so nothing is built
on your server. The same image is on Docker Hub as
maciekzygmunt/excaliself.
latest is the newest release. The app applies database
migrations when it starts, so updating is running a newer image.
mkdir excaliself && cd excaliself
curl -fsSLO https://raw.githubusercontent.com/maciekzygmunt/excaliself/main/docker-compose.yaml
curl -fsSL -o .env https://raw.githubusercontent.com/maciekzygmunt/excaliself/main/.env.example
# set POSTGRES_PASSWORD, BETTER_AUTH_SECRET, and BASE_URL in .env
docker compose up -d
Open BASE_URL (default http://localhost:3000). The first visit takes you to
/setup to create the admin account. Postgres is not published on the host.
Put a reverse proxy with HTTPS in front of port 3000 for anything public.
To update, run docker compose pull && docker compose up -d. To pin a release,
set EXCALISELF_VERSION (e.g. 1.0.0) in .env. To build the image from
source instead (needs about 4 GB of RAM), clone the repo and run
docker compose -f docker-compose.yaml -f docker-compose.build.yaml up -d --build.
The docs have the details.
https://github.com/maciekzygmunt/excaliself, branch main./docker-compose.coolify.yaml.Coolify creates the database, generates the secrets, and assigns a domain, so
there is nothing to configure. If your server has no wildcard domain, first set a
domain on the excaliself service with the container port, e.g.
https://draw.example.com:3000. Open the domain to create the admin account.
To pin a release instead of latest, set
EXCALISELF_VERSION (e.g. 1.0.0) in the resource's environment variables.
Drawings live in the pgdata volume and survive redeploys.
The template runs the app next to a Railway Postgres database. It generates the auth secret and a domain, so there is nothing to configure. Open the domain to create the admin account. To set it up by hand or to upgrade, see the docs.
The button opens Hostinger's Docker Manager with docker-compose.yaml. Before
you deploy, set POSTGRES_PASSWORD, BETTER_AUTH_SECRET, and BASE_URL in the
project's environment, as for Docker Compose. Open BASE_URL
to create the admin account. See the docs.
The docs have the fields to fill in.
Docker Compose reads these from .env. Coolify sets them for you.
| Variable | Required | Description |
|---|---|---|
POSTGRES_PASSWORD |
Yes | Password for the bundled Postgres. Use hex (openssl rand -hex 24): it goes into a connection URL |
BETTER_AUTH_SECRET |
Yes | Session signing secret, at least 32 characters (openssl rand -base64 32) |
BASE_URL |
Yes in production | Public URL of the instance (default http://localhost:3000) |
EXCALISELF_VERSION |
No | Image tag to run: latest (default), a release like 1.0.0 or 1.0, or main |
EXCALISELF_PORT |
No | Host port for the app (default 3000). 127.0.0.1:3000 keeps it local to a reverse proxy |
POSTGRES_USER, POSTGRES_DB |
No | Bundled Postgres user and database (default excaliself) |
IMAGE_UPLOADS_PER_MINUTE |
No | Image uploads allowed per minute, per IP, in each live drawing (default 30). See Environment variables |
GOOGLE_*, MICROSOFT_*, OIDC_*, SSO_ALLOWED_DOMAINS |
No | Single sign-on. See Single sign-on |
PREVIEW_MODE |
No | true runs a throwaway instance for a pull request preview: an in-memory PGlite instead of Postgres, seeded with an admin and example drawings. It ignores DATABASE_URL and BASE_URL and makes BETTER_AUTH_SECRET optional. /preview/login signs in as the admin (admin@example.com / preview-password), /preview/login?account=new as a new member. Data is lost on restart. See PR previews |
PREVIEW_HOSTS |
With PREVIEW_MODE behind a domain |
Comma-separated hosts a preview answers on, e.g. *.draw.example.com. Auth refuses other hosts; localhost always works |
GET /api/health returns 200 when the app is up and can reach Postgres.
If the only admin loses their password, see Recover admin access.
Excaliself has an MCP server at /api/mcp.
Your AI client brings the model, so the instance needs no LLM API key.
Claude.ai (web, desktop, and mobile) signs in with OAuth, with no token.
In Claude, open Settings, then Connectors, click Add custom
connector, and enter https://<your instance>/api/mcp. Then sign in to
Excaliself and
excaliself is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by maciekzygmunt. Your team's whiteboard, on your server. Self-hosted Excalidraw with accounts, folders, and search. It has 175 GitHub stars.
excaliself's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/maciekzygmunt/excaliself" and add it to your Claude Code skills directory (see the Installation section above).
excaliself is primarily written in TypeScript. It is open-source under maciekzygmunt on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh excaliself against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars