Quickstart
Install the mountable.io CLI, sign in, create a persistent filesystem and mount it on Linux or a Mac in a few minutes.
1. Install the CLI
curl -fsSL https://mountable.io/install.sh | sh # standalone binary
npx -y mountable-cli version # or npm
uvx mountable version # or PyPIThe installer checks the package against npm's sha512 and installs to
~/.local/bin. Set MOUNTABLE_VERSION for a specific version or
MOUNTABLE_INSTALL_DIR for another directory. It never uses sudo.
All three channels run the same self-contained Linux/macOS CLI (x64 and
arm64); mounting downloads nothing else. With npm or PyPI, use
npx -y mountable-cli or uvx mountable in place of mountable below.
See Contract and limits for verified platforms.
2. Sign in to the console
Open the console and sign in with an email link or Google. The first time, create an organisation; you become its owner. If you were invited, sign in with the invited address and accept the link instead. See sign-in and invitation help.
An owner or admin must finish the payment-method setup before the organisation can create or mount a filesystem. The console guides you through the prices, agreement and secure payment form. Wait until it confirms the method is ready; merely opening or abandoning the form does not activate it. See Billing.
3. Create a filesystem
In Filesystems, choose Create filesystem, enter a name in the dialog,
then choose Create filesystem to confirm. Note its
id (for example k5q2ztr4mvd7wn3xa6jhebcyfu); you mount filesystems by id,
not their potentially non-unique names. Replace the example ID below with
your own. Members need an owner/admin to create a filesystem and grant access.
4. Sign in the CLI
mountable loginSet MOUNTABLE_API_URL first if your mountable.io API is not at the default
https://mountable.io. The CLI prints a link to /app/device and a short
code. Open the link, check that the code on the page matches the one in your
terminal, then choose Approve.
Wait for the terminal to confirm sign-in. A code expires after ten minutes;
run mountable login again if it expires. Signing out of the approving browser
before the CLI exchanges its approval cancels that unused approval.
5. Mount it
mkdir -p ~/work
mountable mount k5q2ztr4mvd7wn3xa6jhebcyfu ~/workmountable mount needs Linux with FUSE, or a Mac with nothing else installed (Mount on a Mac), and stays in the foreground while the filesystem
is mounted. In another terminal,
~/work is now the filesystem. Add --ro to mount read-only. Owners and admins can mount every filesystem
in their organisation read-write; members mount what they or their groups are
granted.
6. Unmount
mountable unmount ~/work