BBS2GH migration consistently fails at Push step with no detail for a large repo (~2000 branches, multi-GB history around 25gb)

[qsc-vishal-patil]

Summary

Migrating a large Bitbucket Server repository to GitHub via gh bbs2gh migrate-repo
consistently fails at the Push step of the git migration. The archive export and
upload complete successfully (95 parts, ~GBs), but GitHub's importer fails during the
internal push with no actionable detail in the migration log.

Environment

• Tool: gh bbs2gh (GEI) — Bitbucket Server → GitHub (github.com)
• Repo characteristics: ~2000 branches, multi-GB git history, several binary
• Storage: --use-github-storage

Behaviour

• Archive export completes: The export job completed without error (100%)
• Upload completes: all parts uploaded, "Finished uploading archive"
• Import starts, runs IN_PROGRESS for ~20 min, then transitions to FAILED
• Partial progress observed: an earlier run pushed ~72 branches, a later run
  (bbs2gh v1.31.0) pushed ~1875 branches before failing

Failure

26-08-11T13:56:16Z] INFO -- -----------------------------
[2026-08-11T13:56:16Z] INFO -- Git source migration started
[2026-08-11T14:27:51Z] ERROR -- Git source migration failed. Error message: A critical error occurred in the Push step of the git migration.
[2026-08-11T14:27:51Z] INFO -- Git source migration failed
[2026-08-11T14:27:51Z] INFO -- -----------------------------
[2026-08-11T14:27:51Z] INFO -- Migration failed
[2026-08-11T14:27:51Z] INFO -- -----------------------------

Verbose

[DEBUG] RESPONSE (OK): {"data":{"node":{",,"migrationSource":{"name":"Bitbucket Server Source"},"state":"FAILED","warningsCount":0,"failureReason":"Git source migration failed. Error message: A critical error occurred in the Push step of the git migration."}}}
[ERROR] Migration Failed.
[INFO] Migration log available or by running gh bbs2gh download-logs [ERROR] OctoshiftCLI.OctoshiftCliException: Git source migration failed. Error message: A critical error occurred in the Push step of the git migration. at OctoshiftCLI.BbsToGithub.Commands.MigrateRepo.MigrateRepoCommandHandler.ImportArchive(MigrateRepoCommandArgs args, String migrationSourceId, String archiveUrl) at OctoshiftCLI.BbsToGithub.Commands.MigrateRepo.MigrateRepoCommandHandler.Handle(MigrateRepoCommandArgs args) at OctoshiftCLI.Extensions.CommandExtensions.RunHandler[TArgs,THandler](TArgs args, ServiceProvider sp, CommandBase2 command)
at OctoshiftCLI.Extensions.CommandExtensions.<>c__DisplayClass1_0`3.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Invocation.AnonymousCommandHandler.InvokeAsync(InvocationContext)
at System.CommandLine.Invocation.InvocationPipeline.<>c__DisplayClass4_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass17_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass12_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass22_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass19_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c.<b__18_0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass16_0.<b__0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c.<b__5_0>d.MoveNext()
--- End of stack trace from previous location ---
at System.CommandLine.Builder.CommandLineBuilderExtensions.<>c__DisplayClass8_0.<b__0>d.MoveNext()

[brianaj]

Please go through our support channels for assistance.