A self-hosted Kanban board application for personal/team use. Forked from kanbn/kan.

This is a modified version. Per the AGPLv3 license, this fork mochimwaji/kan removes cloud-specific features (Lingui i18n, S3 storage, marketing pages, billing, analytics) for streamlined self-hosting.

• 👁️ Board Visibility: Control who can view and edit your boards
• 🤝 Workspace Members: Invite members and collaborate with your team
• 🎨 Customizable Lists: Color code your lists for better organization
• 🎨 Theme Presets: Choose from 7 beautiful color themes (Ocean Blue, Forest Green, etc.)
• 📅 Calendar View: View cards by due date with drag-and-drop rescheduling
• 🔍 Labels & Filters: Organize and find cards quickly
• 💬 Comments: Discuss and collaborate with your team
• 📝 Activity Log: Track all card changes with detailed history
• 📁 Local File Storage: Avatars and attachments stored locally (no S3 required)
• ✨ Enhanced Animations: Smooth transitions for page navigation and sidebar toggles
• 📧 Email Notifications: Configurable digest and change notifications via SMTP
• 📱 Mobile & PWA: Installable as PWA with touch-optimized calendar and offline support

# docker-compose.yml
services:
  web:
    image: ghcr.io/mochimwaji/kan:latest
    container_name: kan-web
    ports:
      - "3000:3000"
    environment:
      NEXT_PUBLIC_BASE_URL: http://localhost:3000
      BETTER_AUTH_SECRET: your_auth_secret_here
      POSTGRES_URL: postgresql://kan:your_password@postgres:5432/kan_db
      NEXT_PUBLIC_ALLOW_CREDENTIALS: true
    volumes:
      - kan_data:/app/data
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:15
    container_name: kan-db
    environment:
      POSTGRES_DB: kan_db
      POSTGRES_USER: kan
      POSTGRES_PASSWORD: your_password
    volumes:
      - kan_postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  kan_data:
  kan_postgres_data:

docker compose up -d

Access at http://localhost:3000

git clone https://github.com/mochimwaji/kan.git
cd kan
pnpm install
cp .env.example .env  # Configure your environment
pnpm db:migrate
pnpm dev

See .env.example for the complete list.

• Next.js - React framework
• tRPC - Type-safe API
• Drizzle ORM - Database ORM
• Better Auth - Authentication
• Tailwind CSS - Styling

• ✅ Calendar View - Month view with drag-and-drop rescheduling
• ✅ Local File Storage - No S3 required, files stored locally
• ✅ Collapsible Lists - Collapse/expand lists with persistent state
• ✅ Due Date Urgency Colors - Red/orange/yellow based on deadline
• ✅ Theme Presets - 7 predefined color themes
• ✅ Board Transitions - Smooth animations between boards
• ✅ Multi-Card Drag - Bulk update cards in calendar view
• ✅ Mobile Calendar - Touch-optimized vertical day-row layout
• ✅ PWA Support - Installable app with offline page and service worker

• ❌ Lingui i18n (English only)
• ❌ S3 storage (local filesystem)
• ❌ Marketing pages (home, pricing, testimonials)
• ❌ Legal pages (privacy, terms)
• ❌ Analytics (PostHog, Umami)
• ❌ Novu Notifications (replaced with custom SMTP-based system)
• ❌ Billing (Stripe)
• ❌ Trello import

AGPLv3 - Original work by kanbn

Per the license, this modified version mochimwaji/kan provides source code access and carries prominent notices of modifications. See CHANGELOG.md for details.