Skip to main content
Once mounted, your source views appear as directories at ~/airstore/. This page covers how to mount, unmount, and troubleshoot common issues.

​
Cloud mode (default)

If you’re using Airstore Cloud, mounting is simple:
Your source views and tools appear automatically:
No config file needed—everything is configured in the dashboard.

​
How mounting works

Airstore uses FUSE (Filesystem in Userspace) to present a virtual filesystem:
  1. You mount to a directory (e.g., ~/airstore)
  2. File reads go through the FUSE layer
  3. FUSE forwards requests to the Airstore gateway
  4. Gateway fetches data from connected services
  5. Content is returned as file data
The filesystem is virtual—files don’t exist on disk until you read them.

​
Filesystem structure

When mounted, Airstore exposes your source views and tools:

​
Mount options

​
Unmounting

Press Ctrl+C in the terminal where mount is running to gracefully unmount:
If the mount doesn’t respond, press Ctrl+C again to force exit. You can also unmount using system commands:

​
Troubleshooting

Mount fails with “FUSE not found” Re-run the install script, which handles FUSE installation:
Mount point is not empty The mount directory must be empty or not exist:
Permission denied On Linux, you may need to be in the fuse group:

​
Local mode

For self-hosted deployments or development, you can run Airstore in local mode with your own MCP servers. See the Local Deployment Guide for details.