MacOS

A fully native Mac client is coming soon!

You can currently install Object Mount on your Mac directly, or inside a container. Installing Object Mount on your Mac directly will allow you to use cuno-mac, our handy tool for launching Linux containers that automatically have your local installation of Object Mount available inside them.

For those on Apple Silicon (ARM) Macs, macOS 13.0 Ventura or later is required.

  1. All Mac users require a virtualisation/containerisation software to be installed and set up.

Intel

We fully support usage of Docker and Rancher Desktop. Docker is assumed in these guides.

Some settings should be changed to use Object Mount:

Docker

We recommend changing the file sharing implementation to VirtioFS:

  • Open Docker Desktop's Settings panel
  • Open the General section.
  • For the setting Choose file sharing implementation for your containers select VirtioFS.
  • Use the Apply & Restart button to save the change.

  1. Download the installer. By downloading you are agreeing to the terms of the End User License Agreement. Click to download the Scripted Installer.

  2. Install the package onto your Mac directly, or inside a Linux container:

Install on macOS

Installing Object Mount on to your Mac directly will allow you to use cuno-mac, our handy tool for launching Linux containers that automatically have your local installation of Object Mount installed inside them.

NB: To use cuno-mac, you must also have Python 3 installed and available as python3 in Terminal.

In a Terminal on your Mac, navigate to your download directory. If this was the default Downloads folder, you can run:

cd /Users/$USER/Downloads
cd /Users/$USER/Downloads

Run the installer (without sudo):

sh cuno-glibc-installer.run
sh cuno-glibc-installer.run

Please follow the interactive steps, read the displayed end-user licence agreement (EULA) and agree to the terms to continue with the installation.

  • Export the cuno-mac location to your PATH variable:
export PATH=$PATH:~/.local/opt/cuno/share/macos
export PATH=$PATH:~/.local/opt/cuno/share/macos
  • To have this persist and apply to new Terminal sessions, add this as a new line at the bottom of the file /Users/<your username>/.bash_profile using a text editor, or using the following command in a Terminal session:
echo "PATH=\$PATH:~/.local/opt/cuno/share/macos" >> ~/.bash_profile
echo "PATH=\$PATH:~/.local/opt/cuno/share/macos" >> ~/.bash_profile

WARNING: Do not miss the \ because otherwise your current PATH will be written literally into the profile and break future changes.

  1. The installation will prompt you to set the CUNO_ROOT environment variable to the installation directory. This is not always necessary when using Object Mount, but it will make it easier to follow the steps in this guide.
Previous
Glibc
Next
Musl