Skip to main content
In addition to mounting on Linux servers, Archil also supports mounting locally to a macOS machine for occassionally debugging what is happening on the disk. Mounting Archil on macOS is supported on macOS 26 (Tahoe) and later. When you mount an Archil disk to a laptop or desktop in an office, you’re often introducing >100ms of network latency between your computer and the Archil service. As a result, this configuration has reduced performance compared to mounting Archil from an instance in the same cloud region as the Archil file system, and you should not use it for benchmarking how your application runs against the service.
1

Install the macOS client

Mounting Archil on macOS is via a menu bar application. Install it by running the following:
2

Sign in

Click the Archil icon in your menu bar and select Sign in to Archil. Enter the email address associated with your Archil account, then enter the verification code we send you. Your session persists across restarts.
3

Pick a disk

Once you’re signed in, the menu bar lists every disk you have access to — both your personal disks and any disks shared with you through an organization. Disks are grouped by region.If you don’t have a disk yet, create one in the Archil console and click Refresh Disks in the menu.
4

Mount it

Click any disk and select Mount. Archil mounts the disk as a native macOS volume, opens it in Finder, and adds a shortcut to your Finder sidebar. From there, you can browse, edit, and copy files just like any other folder.
5

Unmount when you're done

To unmount cleanly, click the disk in the menu bar and select Unmount. Archil waits for any pending writes to flush to your data source before disconnecting. Quitting the app unmounts every active volume automatically.

​
Checking out files

The macOS client mounts the disk in a shared mode, so it can be simultaneously used by other computers. In this mode, calling archil checkout and archil checkin are not required, but should be used to improve the performance of metadata-heavy workloads such as git clone or npm install. For more information on the semantics of checkin and checkout, see Shared disks. You can “check-out” a file or folder for writing by right-clicking it in Finder and selecting “Check out”. An indicator will appear on the file in Finder to show that it’s locked exclusively for writing. When you’re done working with the folder or file, you can right-click it and select “Check in”.

​
Mount via command line

After installing the application and signing in to your Archil account, you can also mount and unmount disks from the command line. You can mount a disk on macOS by running the following:
On macOS, disks must be mounted underneath the /Volumes directory. You’ll need to specify the region, owner, disk-name, and disk-token to mount. To unmount the disk, you can call:
The command-line interface on macOS is unstable and subject to change — the helper path, URL format, and flags may change in any release. We’re actively working to make this a first-class, supported interface. For anything you depend on, prefer the menu bar, or mount from a Linux client where the archil CLI is fully supported.

​
Sharing data with Linux servers

Disks mounted on your Mac are the same disks you can mount from Linux servers using the archil CLI. Files you create or edit on macOS are immediately visible to any other client mounting the same disk, with full POSIX semantics.