Got questions? Live chat with us in Slack

Anything you contribute, the Mage team and community will maintain. We’re in it together!

Projects to contribute to

If you’re looking for cool projects to ship, check out the following:

GitHub issuesSmall to medium complexity projects
RoadmapSmall to large complexity projects

Set up development environment

  1. Create a new project:
    ./scripts/ [project_name]
  2. Run the below script to build the Docker image and run all the services:
    ./scripts/ [project]
  3. Open your browser and go to http://localhost:3000.

You can find more information about setting up your local environment for development here.


Permission denied

If you get an error relating to permission denied when trying to execute a script, it might have something to do with SELinux.

Two or more containers are trying to mount the same volume. With SELinux it’s not possible without the z option.

For more information about using the z option, read Docker’s documentation.


Instead of using breakpoint(), add the following line to your code where you want a debug:

import pdb; pdb.set_trace()

Attach to running container to use debugger. To get the container ID, run docker ps and look in the NAMES column.

docker attach [container_id]

Backend server

Contributing to the backend server

Front-end app

Contributing to the frontend client

Push code change

  • Fork the Mage github repo:
  • Create a branch in your forked repo and commit your changes
  • Create a pull request
  • Tag Mage team members for PR review (@wangxiaoyou1993, @dy46, @johnson-mage, @tommydangerous)