Skip to content

Document HTTPS proxy workaround for HTTP instances on macOS#160

Open
Byron wants to merge 1 commit intogitbutlerapp:mainfrom
Byron:docs/https-proxy-workaround
Open

Document HTTPS proxy workaround for HTTP instances on macOS#160
Byron wants to merge 1 commit intogitbutlerapp:mainfrom
Byron:docs/https-proxy-workaround

Conversation

@Byron
Copy link
Contributor

@Byron Byron commented Feb 6, 2026

Summary

  • Documents a workaround for macOS/WebKit blocking HTTP connections from GitButler to self-hosted instances (GitLab, GitHub Enterprise, etc.)
  • Adds a new section to the existing Custom CSP troubleshooting page explaining how to use Caddy as a local HTTPS reverse proxy
  • Examples use macOS/Homebrew but note the approach works on any platform

Based on this comment by @nshcr.

Test plan

  • Verify the new section renders correctly on the docs site
  • Confirm Caddyfile syntax highlighting works with the caddyfile language tag

🤖 Generated with Claude Code

@vercel
Copy link
Contributor

vercel bot commented Feb 6, 2026

@Byron is attempting to deploy a commit to the GitButler Team on Vercel.

A member of the Team first needs to authorize it.

@Byron Byron force-pushed the docs/https-proxy-workaround branch from 76cb6ef to e33eb49 Compare February 6, 2026 12:12
WebKit's security mechanisms block HTTP requests from applications,
preventing GitButler from connecting to self-hosted instances over
plain HTTP even with correct CSP configuration. Document using Caddy
as a local HTTPS reverse proxy as a workaround.

Based on: gitbutlerapp/gitbutler#12242 (comment)

Co-authored-by: nshcr <104677079+nshcr@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
@Byron Byron force-pushed the docs/https-proxy-workaround branch from e33eb49 to 025128d Compare February 6, 2026 12:17
@Byron
Copy link
Contributor Author

Byron commented Feb 6, 2026

This PR was created by Claude entirely and I didn't ask it to.
So that is that, but I read the content and it's what I had in mind.

@nshcr
Copy link

nshcr commented Feb 6, 2026

Thanks for creating this PR and listing me as a co-author!
I hadn't realized before that GitButler's documentation is written in MDX - I like MDX.

Back to the main topic: the content generated by Claude is great and pretty much matches what I had in mind for the documentation as well.

What I currently do is place the Caddyfile in my project's root directory, then simply start it with but gui & caddy run. I run it when I start working and shut it down when I'm done, since it's just a workaround for specific project repositories.

By the way, the syntax highlighting language tag for caddyfile was an unexpected discovery - I didn't know GitHub supports it 😆.

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.

2 participants