A tool to migrate GitHub Repositories to Gitea including all issues
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jonas Franz f2c99b3ae2 Add web log (#27) 2 months ago
cmd Add web log (#27) 2 months ago
config Web interface implementation (#18) 3 months ago
migrations Add web log (#27) 2 months ago
web Add web log (#27) 2 months ago
.changelog.yml Add title and note to releases (#20) 4 months ago
.drone.yml Web interface implementation (#18) 3 months ago
.gitignore Web interface implementation (#18) 3 months ago
Dockerfile Fix GitHub Auth by installing new ca certificates (#26) 3 months ago
Dockerfile.web Fix GitHub Auth by installing new ca certificates (#26) 3 months ago
Gopkg.lock Web interface implementation (#18) 3 months ago
Gopkg.toml Web interface implementation (#18) 3 months ago
LICENSE Web interface implementation (#18) 3 months ago
Makefile Web interface implementation (#18) 3 months ago
README.md Web interface implementation (#18) 3 months ago
commands.go Web interface implementation (#18) 3 months ago
commands_web.go Web interface implementation (#18) 3 months ago
config.example.yml Web interface implementation (#18) 3 months ago
main.go Add web log (#27) 2 months ago

README.md

gitea-github-migrator

Build Status Latest Release Docker Pulls Docker Pulls

A tool to migrate GitHub Repositories to Gitea including all issues, labels, milestones and comments.

Features

Migrates:

  • Repositories
  • Issues
  • Labels
  • Milestones
  • Comments
  • Users
  • Pull Requests (as issue)
  • Statuses

Installation

From source

go get git.jonasfranz.software/JonasFranzDEV/gitea-github-migrator
cd $GOPATH/src/git.jonasfranz.software/JonasFranzDEV/gitea-github-migrator
dep ensure
make build

Web Support

Run make web-build instead of make build to include web support.

From Binary

We provide binaries of master builds and all releases at our minio storage server.

Additionally we provide them for every release as release attachment under releases.

You don’t need any dependencies except the binary to run the migrator.

These binaries include web support by default.

From Docker image

We provide a cli docker image:

For master builds:

docker run ggmigrator/cli:latest

For release builds:

docker run ggmigrator/cli:0.0.10

Usage

Command line

Migrate one repository:

gitea-github-migrator migrate \
    --gh-repo owner/reponame \
    --gh-token GITHUB_TOKEN \
    --url http://gitea-url.tdl \
    --token GITEA_TOKEN \
    --owner 1

gh-token is only required if you have more than 50 issues / repositories.

Migrate all repositories:

gitea-github-migrator migrate-all \
    --gh-user username \
    --gh-token GITHUB_TOKEN \
    --url http://gitea-url.tdl \
    --token GITEA_TOKEN \
    --owner 1

Migrate all repositories without issues etc. (classic):

gitea-github-migrator migrate-all \
    --gh-user username \
    --gh-token GITHUB_TOKEN \
    --url http://gitea-url.tdl \
    --token GITEA_TOKEN \
    --owner 1
    --only-repo

Web interface

Since 0.1.0 gitea-github-migrator comes with an integrated web interface. Follow these steps to get the web interface running:

  1. Download or build a web-capable binary of the gitea-github-migrator. The builds on our storage server are build with web support included. If you build from source, please follow web support.
  2. Create config.yml file and change the properties according to your wishes. Please keep in mind that you have to create a GitHub OAuth application to make the web interface work.
  3. Run ./gitea-github-migrator web
  4. Visit http://localhost:4000

Docker

We’re providing a docker image with web support. To start the web service please run:

docker run ggmigrator/web -p 4000:4000 -v data/:/data

Place your config.yml into data/config.yml.

Config

Example:

# GitHub contains the OAuth2 application data obtainable from GitHub
GitHub:
  client_id: GITHUB_OAUTH_CLIENT_ID
  client_secret: GITHUB_OAUTH_SECRET
# Web contains the configuration for the integrated web server
Web:
  port: 4000
  host: 0.0.0.0

Problems

  • This migration tool does not work with Gitea instances using a SQLite database.
  • Comments / Issues will be added in the name of the user to whom belongs the token (information about the original date and author will be added)
  • The current date is used for creation date (information about the actual date is added in a comment)