Skip to content

docs: add setup guide for zrok proxy service - #29

Merged
zlshames merged 11 commits into
BlueBubblesApp:masterfrom
nicoalba:add-zrok-guide
Feb 7, 2026
Merged

docs: add setup guide for zrok proxy service#29
zlshames merged 11 commits into
BlueBubblesApp:masterfrom
nicoalba:add-zrok-guide

Conversation

@nicoalba

@nicoalba nicoalba commented Jan 26, 2026

Copy link
Copy Markdown
Contributor

This PR adds a documentation guide for using zrok as a proxy service.

zrok is already integrated into the BlueBubbles Server settings, but lacked a corresponding guide in the "BYO Proxy" section. This guide helps users who want an open-source, high-bandwidth (5GB/day) alternative to Cloudflare and Ngrok.

Summary of changes:

  • Created a new how-to guide: advanced/byo-proxy-service-guides/zrok-proxy.md
  • Added zrok to SUMMARY.md
  • Added zrok to the README.md, and also alphabetized the options to match SUMMARY.md
  • Added zrok as a recommended alternative in installation-guides/manual-setup.md
  • Successfully tested zrok proxy integration on a macOS Sequoia 15.1 VM. Verified that the *.share.zrok.io tunnel initializes immediately upon saving the token and confirmed the active frontend mapping via the zrok portal.

@nicoalba
nicoalba marked this pull request as ready for review January 27, 2026 19:31
@nicoalba

Copy link
Copy Markdown
Contributor Author

@zlshames last changes made, ready to merge. Thank you

@zlshames
zlshames merged commit fe08003 into BlueBubblesApp:master Feb 7, 2026
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