Troubleshooting mounts on other platforms

​

A sandbox stopped with the disk mounted

• Recent writes can be lost. Writes the client hadn’t sent yet never reach the disk.
• The disk stays locked. The lock still belongs to the client in the old sandbox, so the next exclusive mount fails with:

✗ Unable to mount Archil disk to '/mnt/archil' because another client has an outstanding delegation to the root of the disk, or to any individual file on the disk.

​

Release a stale lock

import * as archil from "disk";

const disk = await archil.getDisk(process.env.ARCHIL_DISK_ID!);
for (const delegation of await disk.listDelegations()) {
  if (delegation.isOrphaned) {
    await disk.revokeDelegation(delegation);
    console.log(`Released ${delegation.path}`);
  }
}

import os

import archil

disk = archil.get_disk(os.environ["ARCHIL_DISK_ID"])
for delegation in disk.list_delegations():
    if delegation.is_orphaned:
        disk.revoke_delegation(delegation)
        print(f"Released {delegation.path}")

Released /

​

The installer fails with libfuse2 ... not installable

archil : Depends: libfuse2 but it is not installable

​

Platform notes

​

E2B

• Run archil mount and archil unmount with user: "root". As the default user, the mount fails with The mount command requires root privileges.
• E2B kills a sandbox when it reaches its timeout, whether or not the disk is unmounted. Set timeoutMs (timeout in Python) longer than the session.

​

Daytona

• archil unmount fails inside a Daytona sandbox with Unable to unmount disk: GenericFailure("No such file or directory (os error 2)"), because the container runtime doesn’t let the client detach a FUSE mount (umount and fusermount3 -u fail too). Run sudo archil sync <path> && sudo archil checkin <path> instead: sync sends every buffered write, and checkin releases the lock. Then delete the sandbox.
• Daytona stops a sandbox after 15 minutes without activity by default. If a session can sit idle longer, raise autoStopInterval when you create the sandbox.
• Pass the mount token as a regular environment variable. With a Daytona secret, the sandbox sees a placeholder instead of the token, and the mount fails with Authentication failed.

​

Modal

• archil mount only works in VM Sandboxes (runtime="vm"). In Modal Functions and in Sandboxes on the default gVisor runtime, it fails with Operation not permitted (os error 1). From those, read and write the disk with the Python SDK instead.
• Modal terminates a Sandbox at its timeout without running a shell trap. Set timeout longer than the work.

​

Vercel Sandbox

• When a sandbox stops or reaches its timeout, the client usually sends its writes and releases the disk on the way out. Stopping it in the middle of heavy writes, such as an npm install, can still leave the disk locked. Unmount before stop(), and call sandbox.extendTimeout() for long jobs.
• Create the sandbox in the Vercel region next to the disk’s region (iad1 for aws-us-east-1, pdx1 for aws-us-west-2, dub1 for aws-eu-west-1). In a distant region, every read that misses the cache crosses the country.