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 Lists Using Images 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
Generating an Access Token Migrating Repositories Using Webhooks
Working with Codeberg's CI
Using Forgejo Actions (Self-hosted)
Integrations with Other Services
Integrating with Keycloak Integrating with LiberaPay Integrating with Matrix Integrating with Read the Docs
Codeberg Translate
Introduction to Weblate Manual Component configuration Getting started
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

Your First Steps on Codeberg

Registering at Codeberg.org

To create your account at Codeberg.org, visit https://codeberg.org 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!

Community

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:

Dashboard

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.

Info

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