=======================
Git Mirroring to GitLab
=======================

Steps for setting up automatic mirroring cron jobs:

* Add a new user:

  .. code:: bash

    sudo adduser --disabled-login --system git-mirroring

* Start a shell as the :code:`git-mirroring` user:

  .. code:: bash

    sudo -H -u git-mirroring /bin/bash

* Switch to home directory:

  .. code:: bash

    cd

* Create an executable file :code:`sync.sh` (replace :code:`nano` with the editor of your choice):

  .. code:: bash

    touch sync.sh
    chmod +x sync.sh
    nano sync.sh

  * Type in the following contents:

    .. code:: bash

      #!/bin/sh
      for repo in ~/*.git; do
          cd "$repo" && git fetch -q && git push -q gitlab || echo "sync failed for $repo"
      done

  * Save and exit the editor.

* Create a ssh key:

  .. code:: bash

    ssh-keygen

  Press enter for all prompts -- leaving the file names as default and with an empty password.

* For each repo to be mirrored:

  * Create an empty repo using the GitLab website.

    .. warning::

      Following these steps will overwrite anything that is in the GitLab repo.

  * Add the ssh key for the