Docs › Getting started

Quick start for engineers

Connect your PC, clone, lock large files and open pull requests.

Once per PC

  1. Install Git for Windows with the default options.
  2. If your administrator says so, run .\mcdock-setup.ps1 -Server https://<server>:8443 in PowerShell. It trusts the server's certificate for Git on this server only.
  3. Sign in to MCDock in the browser and turn on two-factor sign-in under Account → Security. Keep the recovery codes.
  4. With two-factor sign-in, Git uses a personal access token instead of your password: Account → Security → Personal access tokens → New.

Every day

  • Clone: copy the address from the repository page, or use Open in for your IDE.
  • Large files: CAD, PCB and binaries are tracked with Git LFS. Before editing a shared part, lock it: git lfs lock Parts/bracket.SLDPRT, and unlock it after your push.
  • Change something: branch, commit, push, then open a pull request. Reviewers approve, the pipeline must pass, then merge.
  • Issues: report problems and tasks, and mention people with @username.

When something goes wrong

  • "pushes are paused": the server is in maintenance, low on disk or read-only. Clone and pull still work; tell your administrator.
  • "pre-receive hook declined": a branch rule, a locked file or the secret scanner stopped the push. The message says which.

Updated 20 Nov 2026 · Something missing? Ask in the community.