Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: Add Mac M3 Permission Troubleshooting to Documentation #1180

Merged
merged 2 commits into from
Feb 10, 2025
Merged

docs: Add Mac M3 Permission Troubleshooting to Documentation #1180

merged 2 commits into from
Feb 10, 2025

Conversation

EbonyLouis
Copy link
Collaborator

This PR updates the Installation and Troubleshooting guides to address a community raised issue for Mac M3 users where the Goose desktop app fails to launch with no visible window. The root cause is related to file and folder permissions for the ~/.config directory.

Changes Made:

  • Installation Guide

    • Added a Permissions Note for Mac M3 users under the Goose Desktop installation instructions.
    • Linked to the new macOS Permission Issues section in the Troubleshooting Guide for detailed steps on how to check and fix permissions.

  • Troubleshooting Guide

    • Added a new macOS Permission Issues (M3 Macs) section with:
      • Steps to check current directory permissions using the ls -ld ~/.config command.
      • Instructions on how to grant read and write permissions using chmod and mkdir commands.
      • An additional note on enabling Screen Recording Permission in macOS settings, if needed.

@github-actions GitHub Actions
Copy link

github-actions bot commented Feb 10, 2025 •
edited
Loading

PR Preview Action v1.6.0

🚀 View preview at
https://block.github.io/goose/pr-preview/pr-1180/

Built to branch gh-pages at 2025-02-10 21:43 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@EbonyLouis EbonyLouis merged commit 98aecbe into main Feb 10, 2025
3 checks passed
@EbonyLouis EbonyLouis deleted the fix-for-M3-macs branch February 10, 2025 21:44
laanak08 pushed a commit that referenced this pull request Feb 13, 2025
@EbonyLouis @angiejones @laanak08
docs: Add Mac M3 Permission Troubleshooting to Documentation (#1180)
559f1f4 
Co-authored-by: Angie Jones <jones.angie@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@angiejones angiejones angiejones approved these changes

@acekyd acekyd Awaiting requested review from acekyd

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@EbonyLouis @angiejones