[GH-ISSUE #2040] Wrong install instructions #1028

New issue

Closed

opened 2026-03-04 01:50:47 +03:00 by kerem · 1 comment

kerem commented

2026-03-04 01:50:47 +03:00

Owner

Originally created by @bobby-b-song on GitHub (Sep 28, 2022).
Original GitHub issue: https://github.com/s3fs-fuse/s3fs-fuse/issues/2040

The installation note for Mac OSX on https://github.com/s3fs-fuse/s3fs-fuse/wiki/Installation-Notes is wrong.
It should be.


## Mac OSX

Assuming you have installed Homebrew, you'll need to install these dependency packages:

- macfuse
- automake
- gcc
- curl
- libxml2
- pkg-config
- openssl

And as noted in the output of the openssl install, you'll need to set these environment variables:

\```bash
  export LDFLAGS="-L/opt/homebrew/opt/openssl@3/lib"
  export CPPFLAGS="-I/opt/homebrew/opt/openssl@3/include"
  export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl@3/lib/pkgconfig"
\```

Then you should be able to follow the [standard compilation instructions](https://github.com/s3fs-fuse/s3fs-fuse/blob/master/COMPILATION.md).

Users on Apple Silicon M1 Macs have reported the need to ensure that the terminal is not opened using Rosetta. If you're unsure, it's probably safe to try compiling anyway. If compilation fails with an error like "ld: symbol(s) not found for architecture x86_64" then you may need to investigate disabling Rosetta.

Originally created by @bobby-b-song on GitHub (Sep 28, 2022). Original GitHub issue: https://github.com/s3fs-fuse/s3fs-fuse/issues/2040 The installation note for Mac OSX on https://github.com/s3fs-fuse/s3fs-fuse/wiki/Installation-Notes is wrong. It should be. ```markdown ## Mac OSX Assuming you have installed Homebrew, you'll need to install these dependency packages: - macfuse - automake - gcc - curl - libxml2 - pkg-config - openssl And as noted in the output of the openssl install, you'll need to set these environment variables: \```bash export LDFLAGS="-L/opt/homebrew/opt/openssl@3/lib" export CPPFLAGS="-I/opt/homebrew/opt/openssl@3/include" export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl@3/lib/pkgconfig" \``` Then you should be able to follow the [standard compilation instructions](https://github.com/s3fs-fuse/s3fs-fuse/blob/master/COMPILATION.md). Users on Apple Silicon M1 Macs have reported the need to ensure that the terminal is not opened using Rosetta. If you're unsure, it's probably safe to try compiling anyway. If compilation fails with an error like "ld: symbol(s) not found for architecture x86_64" then you may need to investigate disabling Rosetta. ```

kerem closed this issue

2026-03-04 01:50:47 +03:00

kerem commented

2026-03-04 01:50:48 +03:00

Author

Owner

@ggtakec commented on GitHub (Feb 12, 2023):

@spihere Thanks!
Since the path will change depending on where Homebrew is installed, I added a note about that.
(see. https://github.com/s3fs-fuse/s3fs-fuse/wiki/Installation-Notes#mac-osx)

@ggtakec commented on GitHub (Feb 12, 2023): @spihere Thanks! Since the path will change depending on where Homebrew is installed, I added a note about that. (see. https://github.com/s3fs-fuse/s3fs-fuse/wiki/Installation-Notes#mac-osx)