Matorral

<h1 align="center">Matorral</h1> <p align="center"> <strong>A simple and fast open-source project management tool</strong> </p> <p align="center"> <a href="https://matorral.matagus.dev/">Live Demo</a> • <a href="#features">Features</a> • <a href="#getting-started">Getting Started</a> • <a href="#configuration">Configuration</a> • <a href="CONTRIBUTING.md">Contributing</a> </p>

---

Features

• Workspaces - Organize your teams and projects in isolated workspaces
• Projects - Create multiple projects per workspace with unique issue keys
• Issue Hierarchy - Structure work as Epics → Stories → Subtasks and Bugs
• Milestones - Group and track issues toward key delivery points
• Sprints - Plan and execute iterative development cycles
• Priorities & Assignees - Keep your team aligned on what matters most
• Search & Filters - Quickly find any issue across your project
• Authentication - Email and GitHub OAuth login support

Try it out!

An example demo instance is available at matorral.matagus.dev

| Credential | Value | |---|---| | Username | demo@example.com | | Password | demouser789 |

Getting Started

Requirements

• Docker and Docker Compose
• just command runner

Setup

git clone https://github.com/matorral-project/matorral.git
cd matorral
just init               # First-time setup: copies .env, builds containers, runs migrations

This starts the containers and runs migrations. Then:

just start              # Start with logs (foreground)
just start-detached     # Start in background
just logs               # View all service logs
just logs-django        # View Django logs only
just logs-db            # View PostgreSQL logs only

Verify your environment is ready:

just doctor             # Check environment health (.env, containers, migrations)

Open http://localhost:8000. Create an admin account:

just createsuperuser

To stop:

just stop               # Stop all services

See all available commands:

just --list             # List all recipes with descriptions

Configuration

Adjust .env values as needed. Key settings:

| Variable | Description | |---|---| | SECRET_KEY | Django secret key | | DATABASE_URL | Postgres connection string | | REDIS_URL | Redis connection string | | DEBUG | Set to False in production |

Roadmap

Available Now

| Feature | Description | |---|---| | Workspaces | Isolated multi-tenant workspaces for your teams | | Projects | Multiple projects per workspace with unique issue keys | | Issue Hierarchy | Epics → Stories → Subtasks and Bugs | | Milestones | Group and track issues toward delivery goals | | Sprints | Plan and execute iterative development cycles | | Priorities & Assignees | Assign and prioritize work across your team | | Search & Filters | Find any issue quickly across your project | | Authentication | Email and GitHub OAuth login support |

Coming Soon

• Realtime updates
• Drag & drop support
• Integration with GitHub, GitLab, and Bitbucket
• Two-way sync with Jira, Linear, and more
• AI features
• Attachments and images
• Notifications and activity feeds
• And more!

Contributing

We :green_heart: contributions! Please see CONTRIBUTING.md.

Tech Stack

Django · PostgreSQL · Redis · Celery · HTMX · Alpine.js · Tailwind CSS · DaisyUI · Vite

License

GNU Affero General Public License v3.0

---

<p align="center"> <a href="https://matorral.matagus.dev/">Live Demo</a> • <a href="https://github.com/matorral-project/matorral">Star us on GitHub</a> • <a href="https://github.com/matorral-project/matorral/issues">Report Bug</a> • <a href="https://github.com/matorral-project/matorral/issues">Request Feature</a> <a href="https://github.com/matorral-project/matorral/discussions">Ask a Question</a> </p>

---