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

Migrating Repositories

Using a distributed version control software system (like Git) allows you to keep control of the data inside the repository. If you want to download a local copy of your files, you can git clone your repo, or download the repo from the web interface.

This works well for moving files, but when you want to migrate metadata like issues, releases and a wiki, you can use the migration tool.

On Codeberg, you can click on the plus symbol on the top right, and then select New Migration on the dropdown to access the migration tool.

Selecting your host

Once you're at the New Migration page, you can select the Git host you are migrating from. For the following services, the migration tool can not only migrate your repository data, but also metadata like issues, labels, wiki, releases, milestones, etc.

If you cannot find your service, you can select the Git option. This will not migrate mentioned metadata.

Here we document instructions for migrating specific to each service. Once you've followed through, move on to Starting Migration.

Migrating from Git

Here's an explanation of some fields on the Git migration page:

  • Migrate / Clone From URL: This is the URL to your repository. For example: https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git.
  • Username and Password: Optionally, if authentication is required to access the repo, you can enter a username and password here.

Migrating from Services

To migrate a repo with its metadata from a different service, you will first need to create an access token on the service with your repository. Please check your services documentation, on how to get the access token. Examples can be found for Gitlab and Github. Don't forget to delete the access token once you are finished.

Here's an explanation of some fields on the Gitea migration page:

  • Migrate / Clone From URL: This is the URL to your repository. For example: https://code.forgejo.org/forgejo/end-to-end.
  • Access Token: You will paste the access token generated here. An access token is required to migrate metadata or non-public repositories.
  • Migration Items: Here you can select the metadata you want migrated.
  • Owner: The new owner of the migrated repository.
  • Repository Name: The name of the migrated repository.
  • Visibility: Select if the migrated repository should be private or public.
  • Description: Give your migrated repository a description.
Tip

You can also use this method to migrate your repos away from Codeberg to another Gitea or Forgejo instance.

Starting Migration

Once you've filled out all the fields, click the Migrate Repository button. Migration might take a while, depending on how large the repo is.

When the repo code appears, migration is complete!

Inaccessible repo after failed migration

Sometimes a migration might fail for no obvious reasons like timeouts or invalid data in the source repo, leaving you with an inaccessible repo on Codeberg. When you try to navigate to your repo on Codeberg, e.g. https://codeberg.org/knut/example/, you are welcomed with a 500 Internal Server Error.

In this case it might be worthwhile to retry the migration.
First you need to remove the inaccessible repo. To do so, go to the settings page of your repo by appending /settings to the URI, e.g. https://codeberg.org/knut/example/settings. You can delete the repo from here and start over with a new migration.

If this doesn't work out, feel free to open an issue in the Community Issue Tracker.

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