Migrate to GitLab

To migrate your repository run the following commands in your local repository (cd path/to/ogs):

Disable Git LFS

We used Git LFS to store large files but switched back to plain git.

IMPORTANT: Normalize LFS files in your existing branches

If you have branches from pre-GitLab times with e.g. newly created LFS files (benchmark files, images, …) you have to convert them back to plain git:

git add --renormalize .
git commit -m "Converted LFS files to plain git."

Now you have to squash this conversion commit into your original commit which added the files as Git LFS files. In result your branch history should and must not have any Git LFS files! Otherwise GitLab will reject the push!

When you are done migrating your branches you need to disable Git LFS in your local repository:

git lfs uninstall --local

Create a new fork on GitLab

Create a new fork from the official OGS-6 repository.

This creates a new fork under your account with the URL https://gitlab.opengeosys.org/YOUR-USERNAME/ogs.

Migrate your local repositories to point to GitLab

You have to modify your git remotes to point to the new GitLab repositories. Assuming the former official git repository remote is called upstream:

git remote set-url upstream https://gitlab.opengeosys.org/ogs/ogs.git

Assuming your personal forks remote is called origin:

git remote set-url origin git@gitlab.opengeosys.org:YOUR-USERNAME/ogs.git

Or you can clone a fresh repository by following the steps in Get the source code.

This article was written by Lars Bilke. If you are missing something or you find an error please let us know.
Generated with Hugo 0.117.0 in CI job 362666 | Last revision: July 12, 2023
Commit: [PL/SSD] Rename x_dot to x_prev 04a8fec8  | Edit this page on