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.

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

Install: Clarify tarball installation on macOS #111

Merged
merged 2 commits into from
Aug 1, 2024

Conversation

matkuliak
Copy link
Contributor

@matkuliak matkuliak commented Jul 31, 2024

Summary of the changes / Why this is an improvement

Clarify that on macOS permissions need to be added when running a specific version from tarball for the first time

Preview

https://cratedb-guide--111.org.readthedocs.build/install/tarball.html#install-macos

Checklist

@matkuliak matkuliak requested a review from amotl July 31, 2024 23:32
@amotl amotl changed the title Install: Clarify tarbal installation on macOS Install: Clarify tarball installation on macOS Aug 1, 2024
Comment on lines 31 to 40
When installing a specific version of CrateDB from tarball on a macOS
system for the first time, it is possible that you will encounter error:
**"java" cannot be openeded because developer cannot be verified.**

This is expected and can be fixed in your system settings:
- Navigate to **System Preferences** -> **Security and Privacy**
- On the page you will see an **Allow Anyway** button for "java"
- After confirming, run the ``/bin/crate`` command again. You will be
asked to confirm once more with **Open** button. After that CrateDB
will run as expected.
Copy link
Member

Choose a reason for hiding this comment

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

It will be nice to also present a terminal-based variant for unlocking / working around this obstacle.

https://apple.stackexchange.com/a/240560

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Didn't know you could do that in terminal. But there also seems to be some variance to the commands which work for different people, wouldn't want to confuse the user. Let's just stick with GUI variant and if someone knows the terminal way good for them. What do you think?

docs/install/tarball.rst Outdated Show resolved Hide resolved
@matkuliak matkuliak merged commit 2991c2d into main Aug 1, 2024
3 checks passed
@matkuliak matkuliak deleted the mm/macos-tarball-note branch August 1, 2024 07:37
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