Contribute

Ceph is built by a global community. Whether you write code, improve documentation, file bugs, or help others in the forums, every contribution matters.

The Contributor Guide covers everything you need to get started: setting up a development environment, the patch workflow, coding standards, and how review works.

Read the Contributor Guide

How contributions work

  1. Fork the ceph/ceph repository on GitHub.
  2. Create a branch and make your changes, keeping commits focused with clear messages.
  3. Open a pull request against main, or against a stable branch for backports.
  4. CI runs automated tests. Address any failures before requesting review.
  5. A component lead or maintainer reviews your patch. Engage with feedback and iterate.
  6. Once approved, your patch is merged. Backports to stable releases are tracked separately.

Ways to contribute

  • Code

    Fix bugs, implement features, or improve performance across any of Ceph's subsystems. All development happens in the open on GitHub, and the Contributor Guide walks you through the patch workflow, CI requirements, and review process.

    Contributor Guide

  • Documentation

    The Ceph documentation lives alongside the code and welcomes improvements at any level, from fixing typos to writing new guides. The DocuBetter meeting is a regular forum for documentation contributors to coordinate and get feedback.

    Documentation guide

  • Testing & bug reports

    Running Ceph and hitting a bug? Filing a detailed issue on the Ceph tracker is one of the most valuable things you can do. Include your Ceph version, cluster configuration, and the steps to reproduce.

    Ceph issue tracker

Get involved

  • Ceph Developer Monthly call

    A monthly video call open to all contributors. Agendas and connection details are posted to the dev mailing list.

  • Mailing lists

    Development discussion happens on the dev list; operational questions and community support on ceph-users.

  • Chat & events

    Join the community on Slack, follow meetups and events, and find every channel on the connect page.

  • Code of Conduct

    All Ceph community spaces are governed by the Ceph Code of Conduct. Please read it before participating.

Your first patch

New to Ceph development? This walkthrough covers setting up a development environment and submitting your first patch.