Skip to main content
Archil for macOS makes it simple to use Archil disks from a macOS machine. It lives in the menu-bar and supports mounting disks with FSKit, so it doesn’t require any additional kernel modules. Archil for macOS only works on macOS 26 (Tahoe) and later.
Archil for macOS is intended for debugging and testing — browsing files, inspecting data, and validating changes from your laptop. It is not suitable for benchmarking. You’ll always get the best performance by mounting a disk from a Linux client running in the same cloud region as the disk, where round-trip latency to the data source is measured in microseconds rather than the tens of milliseconds typical of a home or office network.

Install

Run the following on your machine to install Archil.app:
curl -s https://archil.com/install | sh

First launch

1

Sign in

Click the Archil icon in your menu bar and choose 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.
2

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.
3

Mount it

Click any disk and choose 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.
4

Unmount when you're done

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

Latency indicators

You get the best performance with Archil disks by using either Serverless execution or by mounting from the same cloud region. As a result, we expect performance degradation when mounting Archil from a local macOS machine that increases based on the amount of latency to your cloud region. We show you a latency indicator in the menu bar, so you know the scale of degradation to expect.

Using delegations

Archil disks are always mounted on macOS in shared mode, which mean that some write functions of the file system are unavailable by default. For specific information on how to work with shared disks, 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 available for writing. When you’re done working with the folder or file, you can right-click it and select “Check in”.

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. See shared disks for details on concurrent access from multiple clients.