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
cp .env.example .env   # review and set required variables (e.g. SECRET_KEY)
just init

This starts the containers and runs migrations. Then:

just start              # start with logs
just start-detached     # start in background
just logs               # tail logs (useful after start-bg)

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

just createsuperuser

To stop:

just stop

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

---