Skip to content

Clarify the macOS requirement for container hosts - #37

Draft
qayshp wants to merge 2 commits into
BlueBubblesApp:masterfrom
qayshp:agent/clarify-macos-container-requirement
Draft

Clarify the macOS requirement for container hosts#37
qayshp wants to merge 2 commits into
BlueBubblesApp:masterfrom
qayshp:agent/clarify-macos-container-requirement

Conversation

@qayshp

@qayshp qayshp commented Jul 23, 2026

Copy link
Copy Markdown

What changed

  • explain why the BlueBubbles server must run within macOS
  • distinguish a native Linux or Windows container from a Linux-hosted macOS VM
  • link readers to the existing virtualization and Docker-OSX guides

Why

The server overview said that macOS virtual machines are compatible, but it did not explicitly answer whether BlueBubbles could run as an ordinary Linux or Windows container. That omission made Docker and Podman deployments sound platform-independent even though the server depends on the macOS Messages app, chat.db, AppleScript, and optional macOS-only Private API frameworks.

This clarification makes the deployment boundary explicit: Docker or Podman can host a macOS virtual machine, but BlueBubbles still runs inside the macOS guest.

Impact

Readers can choose an appropriate host setup without mistaking the Docker-OSX path for a native Linux server.

Checks

  • git diff --check
  • verified both linked documentation targets exist in the repository
  • checked the wording against the maintainer explanation on the issue

Fixes BlueBubblesApp/bluebubbles-server#762

@qayshp qayshp left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self-review focused on whether the new deployment guidance sets the right expectations.

Comment thread server/README.md Outdated
@qayshp

qayshp commented Jul 23, 2026

Copy link
Copy Markdown
Author

Validation update

  • git diff --check origin/master...HEAD passes.
  • Both linked documentation targets resolve in the repository.
  • The deployment-boundary explanation matches the current server's macOS Messages database, AppleScript, and optional Private API dependencies.
  • No runtime or SIP-disabled-machine test is needed for this conceptual clarification.

No documentation screenshot is needed for this change.

@qayshp
qayshp marked this pull request as ready for review July 28, 2026 07:02
@qayshp
qayshp marked this pull request as draft July 28, 2026 07:30
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.

Possibility to run it on a docker or podman instance, like regular services?

1 participant