What to do if hatch env create hangs?

[gerbendekkervolue]

I had a case where hatch env create did not continue but hung indefinitely. How should I deal with such a case?

[gerbendekkervolue]

Answering my own question here after a discussion with ofek here.

First thing you should do is running in verbose mode, like hatch -vvv env create as documented here

It might be you have the same problem I had if you see the package installation stopping at a line looking like
"PACKAGE_NAME @ git+ssh://[email protected]/REPO/[email protected]"

If you install a package in this way, and have a passphrase protected ssh key, pip would prompt you for a password. Hatch however does not, and will therefore hang.

One way of solving this is by storing your ssh passphrase to your local ssh agent with a command like

ssh-add -K /Users/you/.ssh/id_rsa

See https://www.atlassian.com/git/tutorials/git-ssh for a beginner-friendly explanation, and Stack Overflow for related issues.