Press / to focus
Codeberg Documentation

Getting Started with Codeberg
What is Codeberg? Your First Steps on Codeberg Install Git Your First Repository The Basics of Issue Tracking Integrated Wiki Email Settings Licensing on Codeberg Frequently Asked Questions
Collaborating with Others
Citable Code Pull requests and Git flow Invite Collaborators Create and Manage an Organization Repository Permissions Resolve Conflicts
Working with Git Repositories
Using .gitignore Configuring Git Clone & Commit via CLI Clone & Commit via Web Merge multiple commits into one Tags and Releases Working with large files
Writing in Markdown
Introduction to Markdown Using Links Topics Preformatted Text Using Images Using Lists Tables in Markdown Markdown FAQ
Security
Setting up two-factor authentication Adding an SSH key to your account Verifying you're connected to Codeberg using SSH fingerprints Adding a GPG key to your account
Codeberg Pages
Using Custom Domains Troubleshooting Example: Docs as Code with Sphinx Pushing output from SSGs into Codeberg Pages Redirects
Advanced Usage
Using Webhooks Generating an Access Token Migrating Repositories
Working with Codeberg's CI
Using Forgejo Actions (Self-hosted)
Integrations with Other Services
Integrating with Keycloak Integrating with Matrix Integrating with Read the Docs
Codeberg Translate
Getting started Manual Component configuration Introduction to Weblate
Improving Codeberg
Contributing Code
Improving the Documentation
Style Guide How to create a new article? Can I preview my article? How to make screenshots for Codeberg Documentation? Documentation Contributor FAQ
Contact

Integrating with Matrix

This article will guide you through integrating Codeberg with Matrix, allowing repo updates to be automatically broadcast to your project's Matrix room.

Create a new Matrix account

To set up the Matrix integration, it is recommended that you create a new account dedicated to broadcasting your repo updates. This will act as a bot account. You can create an account on your preferred Matrix server.

Getting an access token

You will need an access token to give Codeberg access to send updates from your dedicated Matrix account. Here's how to do it on the Element web client.

  1. Log in to the Element web client in a private/incognito browser window, with the Matrix account you created earlier.
  2. Click on your account name in the top-left corner, then click on All Settings in the dropdown.
  3. Optionally, you can set a display name and a profile picture for the account here.
  4. Navigate to the Help & About tab on the left.
  5. Scroll to the bottom and click on the Access Token dropdown in the advanced section.
  6. Copy the access token that appears to a safe place.
  7. Do not log out of Element. This will invalidate your access token. Instead, you can simply close your private/incognito browser.
Tip

Alternatively, you can get an access token directly from the Matrix API. Read more at Matrix's documentation.

Connecting your repo to your Matrix using webhooks

Now we will connect the Matrix bot to your Codeberg repository. You will need admin permissions for the repo.

webhooks

  1. In a web browser, go to your repo and click on the Settings button on the top right.

  2. Navigate to the Webhooks settings tab.

  3. Click on the Add Webhook button and select Matrix.

  4. Here are explanations for some key fields:

    • Homeserver URL: for example https://matrix.org
    • Room ID: for example !VTjWrzxSWgLJnHgDUd:matrix.org. You can find this on Element in the Advanced tab for the room settings.
    • Access token: type Bearer <your_access_token>. The access token is the one you got earlier.
    • Message type: m.text is the most basic type of plaintext message, whereas m.notice is intended for bots and behaves slightly differently.

Add your webhook, then click on the webhook URL. At the bottom now, there will be a Test Delivery button. Click this, and you will receive a message on your Matrix room!

Hey there! 👋 Thank you for reading this article!

Is there something missing, or do you have an idea on how to improve the documentation? Do you want to write your own article?

You're invited to contribute to the Codeberg Documentation at its source code repository, for example, by adding a pull request or joining in on the discussion in the issue tracker.

For an introduction on contributing to Codeberg Documentation, please have a look at the Contributor FAQ.

© Codeberg Docs Contributors. See LICENSE