{"id":27128168,"url":"https://github.com/tin-cat/migrate-issues-gitlab-to-github","last_synced_at":"2025-04-07T18:35:49.711Z","repository":{"id":269405763,"uuid":"907309570","full_name":"tin-cat/migrate-issues-gitlab-to-github","owner":"tin-cat","description":"A tool to migrate issues from GitLab to GitHub","archived":false,"fork":false,"pushed_at":"2025-01-21T16:11:14.000Z","size":51,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T08:35:31.700Z","etag":null,"topics":["git","github","gitlab","issues","migration"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tin-cat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-23T09:48:12.000Z","updated_at":"2025-04-02T12:04:11.000Z","dependencies_parsed_at":"2024-12-23T11:18:41.481Z","dependency_job_id":"94e30c8a-7e72-4ab4-a507-0039a3a2a5bf","html_url":"https://github.com/tin-cat/migrate-issues-gitlab-to-github","commit_stats":null,"previous_names":["tin-cat/migrate-issues-gitlab-to-github"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tin-cat%2Fmigrate-issues-gitlab-to-github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tin-cat%2Fmigrate-issues-gitlab-to-github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tin-cat%2Fmigrate-issues-gitlab-to-github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tin-cat%2Fmigrate-issues-gitlab-to-github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tin-cat","download_url":"https://codeload.github.com/tin-cat/migrate-issues-gitlab-to-github/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247707846,"owners_count":20982861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git","github","gitlab","issues","migration"],"created_at":"2025-04-07T18:35:15.314Z","updated_at":"2025-04-07T18:35:49.692Z","avatar_url":"https://github.com/tin-cat.png","language":"PHP","readme":"# migrate-issues-gitlab-to-github\nA tool to migrate issues from a repository at GitLab to a repository at GitHub.\n\n## Requirements\n- PHP 8\n- Composer\n\n## Usage\nClone the repository to a machine with PHP 8:\n```bash\ngit clone https://github.com/tin-cat/migrate-issues-gitlab-to-github.git\n```\n\nInstall dependencies\n```bash\ncomposer install\n```\n\nYou can either setup the importation by creating an `.env.local` file, by providing all the needed setup via parameters, or by calling the tool with no parameters to get asked interactively.\n\n**Setup with an .env.local file**\n\nCopy the provided `.env.local.example` file as reference and fill in your configuration parameters:\n\n```\n# GitLab configuration\nGITLAB_TOKEN=\nGITLAB_PROJECT_ID=\n\n# GitHub configuration\nGITHUB_TOKEN=\nGITHUB_USERNAME=\nGITHUB_REPOSITORY=\n```\n\nTo run the importation\n```bash\nphp bin/console app:import\n```\n\n**Specifying all configuration parameters in the command line instead**\n\nList of available parameters:\n\n```bash\nphp bin/console app:import --help\n```\n\nRun the importation\n\n```bash\nphp bin/console app:import \\\n--gitLabToken=\u003cYour GitLab token\u003e \\\n--gitLabProjectId=\u003cYour source GitLab project id\u003e \\\n--gitHubToken=\u003cYour GitHub token\u003e \\\n--gitHubUserName=\u003cYour GitHub user name\u003e \\\n--gitHubRepository=\u003cYour destination GitHub repository name\u003e\n```\n\nPlease note that all authentication and repository identification parameters are required if you haven't set them up in an `.env.local` file.\n\n## Features\n- Tries to be gentle with APIs to avoid triggering rate limits.\n- Tries to be idempotent so running the tool multiple times shouldn't create duplicates.\n\n## Downsides\nIt only imports the following information from issues:\n- title\n- body\n- status (Either open or closed)\n\n## Please notice\n- Imported issues on GitHub are assigned to the authenticated user via GITHUB_TOKEN\n\n## License\nGNU General Public License v3\n\n## Contribute\nPlease feel free to contribute your issues and merge requests.\n\n## Credits\nThanks to:\n- [KNP Labs](https://github.com/KnpLabs) and their contributors for their PHP API client for GitHub [php-github-api](https://github.com/KnpLabs/php-github-api)\n- The creators and contributors of the [GitLab PHP API Client](https://github.com/GitLabPHP)\n\n## Other similar tools\nThis tool is designed as a very simplistic migration with some limitations. It is also designed so it is easily modifiable to solve your own issue migration needs.\n\nThere are other projects aimed also at migrating issues from GitLab to GitHub, and are arguably better built and more feature-rich than this solution:\n\n- [gitlab-github-migrate](https://github.com/wollzelle/gitlab-github-migrate)\n- [node-gitlab-2-github](https://github.com/piceaTech/node-gitlab-2-github)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftin-cat%2Fmigrate-issues-gitlab-to-github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftin-cat%2Fmigrate-issues-gitlab-to-github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftin-cat%2Fmigrate-issues-gitlab-to-github/lists"}