Your First Steps on Codeberg

Registering at

To create your account at, visit and click on "Register" to bring up the registration form.

Then, simply fill in your username and email address and then choose a good password.

After confirming your email address by clicking the link in the email we sent you, you're done and good to go!


Codeberg is a non-profit volunteer effort. It relies on its friendly and dedicated community. We're happy that you're now a part of our community, too, and we hope you're feeling welcome!

We kindly ask you to be polite and civil when on Codeberg and to not excessively use the resources provided. Please see our Terms of Use for details.

Please remember that everyone here is contributing on their free time, as volunteers.

If you like a project on Codeberg, consider giving it a star and/or following its author. This helps with building and growing a network of free software projects and people, and can serve as guidance for users exploring Codeberg, looking for interesting projects to try out or contribute to.

Orienting yourself on Codeberg

After successfully registering on Codeberg, you should see something similar to this screen:


An explanation of the highlighted elements above:

  • Dashboard (1) is the screen you're looking at right now. It gives you an overview of the latest activity from you, the people you follow and in your or your organization's projects.
  • Issues (2) and Pull Requests (3) These are overviews of issues and pull requests that you are either involved in or that are part of one of the organizations you belong to.
  • Codeberg Issues (4) This is currently the primary communication channel for the Codeberg Community. Here, you can ask questions, report bugs and suggest changes to Codeberg. You're also welcome to browse these issues and contribute your solutions, if you want to support Codeberg even more.
  • The Create Menu (5) You can create repositories, organizations and migrate repositories using this menu. It's your entry point to kicking off entirely new projects on Codeberg.
  • Your Avatar (6) will lead you to a menu, where you can look at your profile, edit your settings, read the documentation of Forgejo (the software Codeberg is based on) or log out.
  • The Dashboard Context Switcher (7) If you're part of one or more organizations, you can use this context switcher to let the dashboard display information relevant to the organization, rather than your account.

A word about Security

While it is important to choose a strong password, it is also important to use Two-Factor Authentication in case your password or device ever gets compromised, so that should be one of the first things to configure after you have created your account.

We recommend that you use Two-Factor Authentication, to increase your security.


Please visit the guide in the security section to learn how to set up 2FA.

Moving on from here

Now that you have an account on Codeberg, you can choose from a number of possible ways to explore:

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