Troubleshooting

Use these steps for common GitStart Lite problems.

Git is missing

GitStart needs Git on your PATH.

git --version

Install Git from your platform package manager or from git-scm.com.

On Windows, use Git Bash or ensure Git is in your shell PATH.

Bootstrap download failed

Check your network connection. Confirm the site URL is correct before you publish.

You can download the release file and run it directly. See download and run.

Windows Git Bash: curl certificate revocation error

On Windows, Git Bash may use curl with schannel. You may see:

curl: (35) schannel: ... CRYPT_E_NO_REVOCATION_CHECK ... unable to check revocation for the certificate.

This is a local SSL check on your machine or network. GitStart is not broken.

Try the launch command with revocation checking disabled for this download:

bash -c "$(curl -fsSL --ssl-no-revoke https://richardp23.github.io/gitstart-lite/run)"

Some networks still block every curl path. Use PowerShell or your browser instead:

powershell -Command "Invoke-WebRequest -Uri 'https://richardp23.github.io/gitstart-lite/releases/v0.5.0/gitstart.sh' -OutFile gitstart.sh"
powershell -Command "Invoke-WebRequest -Uri 'https://richardp23.github.io/gitstart-lite/releases/v0.5.0/gitstart.sh.sha256' -OutFile gitstart.sh.sha256"

Then in Git Bash:

sha256sum -c gitstart.sh.sha256
bash gitstart.sh

Or open the release links in your browser. See download and run.

School or office networks sometimes block revocation checks. Ask your instructor if the problem continues.

Checksum verification failed

Do not run a file when the checksum does not match.

Download the release file and the gitstart.sh.sha256 file again from the same version.

sha256sum -c gitstart.sh.sha256

On macOS:

shasum -a 256 -c gitstart.sh.sha256

No checksum tool

The bootstrap warns when SHA-256 is not available. You can confirm to continue or stop.

Install a checksum tool, or download the release and verify the checksum on another machine.

Download and run

Download releases/v0.5.0/gitstart.sh and gitstart.sh.sha256. Verify the checksum. Then run:

bash gitstart.sh

See download and run for full steps.

Network required for remote steps

Fetch, pull, and push need network access to the remote host.

When a remote step fails, GitStart names the step and keeps your local repository unchanged.

Back to launch page