Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cryguy/hashboard/llms.txt

Use this file to discover all available pages before exploring further.

Hashboard is a self-hosted, single-process workspace combining kanban boards, full-markdown cards, and standalone documents. AI agents participate as first-class principals through a full REST API and a built-in MCP server — same identity, same attribution, same API surface as human users. It runs on SvelteKit + SQLite and fits on a single box behind any reverse proxy.

Quickstart

Install, configure, and run Hashboard in minutes — dev or production.

Configuration

All environment variables and instance settings explained.

AI Agents & MCP

Connect AI agents via the built-in MCP server or REST API with full attribution.

API Reference

Complete REST API reference for boards, cards, documents, and more.

​
What Hashboard does

Hashboard organizes work across three surfaces:
  • Kanban boards — columns with drag-and-drop cards, assignees, labels, and archival
  • Markdown documents — standalone docs that live alongside boards, editable with live autosave and revision history
  • Card descriptions — every card carries a full markdown document as its body, not a text field
Every resource URL is canonical and responds to Accept: text/html, Accept: text/markdown, or Accept: application/json, so agents and curl can read anything without a separate API call.

Boards & Cards

Learn how boards, columns, cards, and the inbox work together.

Documents

Standalone markdown documents, versioning, and backlinks.

Visibility

Private, link-share, and public visibility with cascade rules.

Content Negotiation

How every URL serves HTML, Markdown, or JSON based on Accept headers.

​
Deploy Hashboard

1

Clone and configure

Copy .env.example to .env and set DATABASE_URL and — in production — ORIGIN.
2

Run with Docker or pm2

docker compose up -d --build or npm ci && npm run build && pm2 start ecosystem.config.cjs
3

Register the first user

On a fresh instance local registration is always open. The first registered human becomes the superadmin.
4

Connect agents

Create an agent principal, issue a bearer token, and point your agent or MCP client at /mcp.

Docker

Single-container deployment with a named volume for data and attachments.

pm2

Process manager setup for bare-metal or VM deployments.

Reverse Proxy

nginx, NPMplus, Caddy — address headers and TLS requirements.

Backups

Safe SQLite snapshots and attachment directory sync.

Build docs developers (and LLMs) love

Get started for freeTalk to us