Matorral

A simple and fast open-source project management tool

Live Demo • Features • Getting Started • Configuration • Contributing

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 💚 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

Live Demo • Star us on GitHub • Report Bug • Request Feature Ask a Question

matorral-project/matorral