This is an automated email from the ASF dual-hosted git repository.
jan pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/couchdb.git
The following commit(s) were added to refs/heads/main by this push:
new b5dfe1200 doc: update install instructions
b5dfe1200 is described below
commit b5dfe12007af3d57041425956fd07c707b98c1c2
Author: Jan Lehnardt <[email protected]>
AuthorDate: Thu Oct 2 16:55:03 2025 +0200
doc: update install instructions
---
INSTALL.Unix.md | 18 ++++++++++++------
README-DEV.rst | 6 +++---
2 files changed, 15 insertions(+), 9 deletions(-)
diff --git a/INSTALL.Unix.md b/INSTALL.Unix.md
index a07889798..a27ff626a 100644
--- a/INSTALL.Unix.md
+++ b/INSTALL.Unix.md
@@ -1,6 +1,6 @@
# Apache CouchDB INSTALL.Unix
-A high-level guide to Unix-like systems, inc. Mac OS X and Ubuntu.
+A high-level guide to Unix-like systems, inc. macOS and Ubuntu.
Community installation guides are available on the wiki:
@@ -84,9 +84,9 @@ You can install the dependencies by running:
You can install Node.JS via
[NodeSource](https://github.com/nodesource/distributions#rpminstall).
-### Mac OS X
+### macOS
-To build CouchDB from source on Mac OS X, you will need to install
+To build CouchDB from source on macOS, you will need to install
the Command Line Tools:
xcode-select --install
@@ -96,6 +96,12 @@ You can then install the other dependencies by running:
brew install autoconf autoconf-archive automake libtool \
erlang icu4c spidermonkey pkg-config
+Note that newer versions of Homebrew install `icu4c` as “keg-only”.
+That means the CouchDB build system can’t find it. Either follow
+the instructions presented by Homebrew or run
+
+ brew link icu4c
+
You can install Node.JS via the
[official Macintosh installer](https://nodejs.org/en/download/).
@@ -103,9 +109,9 @@ You will need Homebrew installed to use the `brew` command.
Learn more about Homebrew at:
- http://mxcl.github.com/homebrew/
+ https://brew.sh
-Some versions of Mac OS X ship a problematic OpenSSL library. If
+Some versions of macOS ship a problematic OpenSSL library. If
you're experiencing troubles with CouchDB crashing intermittently with
a segmentation fault or a bus error, you will need to install your own
version of OpenSSL. See the wiki, mentioned above, for more information.
@@ -169,7 +175,7 @@ On many Unix-like systems you can run:
--group --gecos \
"CouchDB Administrator" couchdb
-On Mac OS X you can use the Workgroup Manager to create users up to version
+On macOS you can use the Workgroup Manager to create users up to version
10.9, and dscl or sysadminctl after version 10.9. Search Apple's support
site to find the documentation appropriate for your system. As of recent
versions of OS X, this functionality is also included in Server.app,
diff --git a/README-DEV.rst b/README-DEV.rst
index 12ad36473..d6dcc4a55 100644
--- a/README-DEV.rst
+++ b/README-DEV.rst
@@ -111,8 +111,8 @@ Centos 7 and RHEL 7
python-pygments gnupg nodejs npm
-Mac OS X
-~~~~~~~~
+macOS
+~~~~~
Install `Homebrew <https://brew.sh/>`_, if you do not have it already.
@@ -120,7 +120,7 @@ Unless you want to install the optional dependencies, skip
to the next section.
Install what else we can with Homebrew::
- brew install help2man gnupg md5sha1sum node python
+ brew install help2man gnupg md5sha1sum node python elixir
If you don't already have pip installed, install it::
