Gickup

Getting started

Gickup is a tool that allows you to clone/mirror repositories from one hoster to another. This is useful if you want to have a backup of your repositories on another hoster or to a local server.

References

• Docs
• GitHub repo

---

1. Download tarball

   wget https://github.com/stefanprodan/gickup/releases/download/v0.10.39/gickup_0.10.39_linux_amd64.tar.gz

2. Verify checksum

   echo "c3d3e647189c4379d8d70b9223bd4fe5eb293b289ece5931ff2e10064b063a67  gickup_0.10.39_linux_amd64.tar.gz" | sha256sum -c -

3. Extract and move

   tar -xzf gickup_0.10.39_linux_amd64.tar.gz && sudo mv gickup /usr/local/bin/gickup

4. Make executeable

   sudo chmod +x /usr/local/bin/gickup

5. Create backup/config directory

   mkdir -p ~/.config/gickup

6. Create token(s)

   Local

   GitHub token

   Requires these permissions:

   • all:repo - Full control of public and private repositories.
   • read:gist - Read user gists.
   • read:org - (Optional) Read-only access to organization membership and repos.
   Gitea

   GitHub token

   Requires these permissions:

   • all:repo - Full control of public and private repositories.
   • read:gist - Read user gists.
   • read:org - (Optional) Read-only access to organization membership and repos.

   Gitea token

   Requires these permissions:

   • write:org - Read/write access to organization membership and repos.
   • write:repo - Full control of public and private repositories.
   • write:user - Read/write access to user.
   
   

7. Create config

   Local

   nano ~/.config/gickup/local.config.yaml

   local.config.yaml

   source:
     github:
       - token: "YOUR_GITHUB_TOKEN"
         wiki: false
         issues: false
         starred: false
         gists: true
   
   destination:
     local:
       - path: "/home/{USERNAME_VAR}/Documents/gh-backup"
         structured: true
         bare: true
         mirror: true

   Gitea

   nano ~/.config/gickup/gitea.config.yaml

   gitea.config.yaml

   source:
     github:
       - token: "YOUR_GITHUB_TOKEN"
         wiki: false
         issues: false
         starred: false
         gists: false
   
   destination:
     gitea:
       - token: "YOUR_GITEA_TOKEN"
         user: "YOUR_GITEA_USERNAME"
         url: http://localhost:3004
         lfs: false
         mirror:
           enabled: true
           mirrorinterval: 2h0m0s

   
   

8. Run

   Local

   gickup ~/.config/gickup/local.config.yaml

   Gitea

   gickup ~/.config/gickup/gitea.config.yaml