Skip to content

docs(install): add troubleshooting section#29

Merged
KailasMahavarkar merged 1 commit intomainfrom
fix/install-troubleshooting
Apr 10, 2026
Merged

docs(install): add troubleshooting section#29
KailasMahavarkar merged 1 commit intomainfrom
fix/install-troubleshooting

Conversation

@KailasMahavarkar
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a Troubleshooting section to install.md with four sub-sections
  • Covers the unauthorized pull error caused by ghcr.io packages defaulting to private (most common install failure right now)
  • Documents how to set the package public via GitHub package settings, with a link to the official GitHub docs
  • Covers: MCP not starting, SessionStart hook not firing, and missing Bun

Test plan

  • Read through the new section and confirm instructions are accurate
  • Confirm the ghcr.io package is set to public after following the instructions

🤖 Generated with Claude Code

Covers private Docker image (unauthorized pull), server not starting,
SessionStart hook not firing, and missing Bun. Includes direct link
to GitHub package visibility docs for the ghcr.io private-by-default issue.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KailasMahavarkar KailasMahavarkar merged commit c124290 into main Apr 10, 2026
4 checks passed
@KailasMahavarkar KailasMahavarkar deleted the fix/install-troubleshooting branch April 10, 2026 12:05
KailasMahavarkar added a commit that referenced this pull request Apr 14, 2026
docs(install): add troubleshooting section
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant