Troubleshooting quick reference
- "Command not found" for
git,node,gh, orclaude— the install in Part A didn't finish, or you need to close and reopen your terminal for it to notice the new program. ./deploy.shsays you have uncommitted changes — commit them first (git add+git commit), or add them to.gitignoreif they're not meant to be tracked at all (like.claude/).- SSH asks for a password / hangs — the key wasn't copied to the VPS correctly (redo Part C2), or you're pointing at the wrong key file.
- Site is down after a deploy — SSH in and run
docker logs your-project-name-web-1 --tail 100to see the actual error message. - A PR shows as "merged" but the live site didn't update — always
double check with
git log --oneline origin/main -3before deploying; don't assume a merge happened just because it was supposed to.
Published