airmsh01 / PLAN THE WORKSPACE
An encrypted drive for your team.
Use AirFS for project assets, research files, or shared work without keeping a full copy on every device. Files are encrypted, and you control who can open each folder.
One person can edit a drive at a time while others have read-only access. Live collaboration and moving a drive between storage providers are not available yet.
You need an Airmsh account with drive access and either Airmsh storage or your own supported storage account. Airmsh sets up its managed storage; you do not enter Airmsh’s storage credentials.
| Airmsh storage | My own storage |
|---|---|
| Airmsh provides the storage. Choose a drive name and limits from the available options. | Connect your own supported storage account. Its credentials stay on the owner’s computer. |
| Airmsh grants only the access needed for your drive. | The owner’s computer must stay online to approve shared access. |
Airmsh can see drive and folder names and permissions, but not the encrypted file contents. For your own storage, your storage credentials and drive keys remain on the owner’s computer.
02 / CREATE
Choose your storage. Allocate a drive.
Airmsh-managed storage
- Airmsh makes managed storage available to your organization.
- As an organization owner or admin, open Files. In the AirFS area, choose Create a drive (or New drive when drives already exist) and select Airmsh storage.
- Enter a drive name, drive quota, and local cache size. Choose only the space this drive needs.
- Create the drive and confirm it appears under Your drives. Changing storage options later does not move existing files automatically.
Your own bucket
- On the owner’s computer, open Files → Create a drive, choose My own S3 storage, and select a supported provider such as AWS, Hetzner, or Vultr.
- Enter the storage details and credentials requested by Airmsh. Give the account only the permissions this drive needs.
- Create the drive and keep the owner’s computer online when sharing. Its storage credentials stay there.
Back them up using your organization’s secure process. Losing them can make encrypted files unrecoverable. Never paste storage credentials into chat, screenshots, or public documentation.
Drive limits are not a storage-cost estimate. Saved versions and transfers may increase your provider’s bill.
03 / ATTACH
Open the drive on the right platform.
Open Files, select the drive under Your drives, review its permissions, choose read-only when appropriate, and press Attach. Detach before changing who can edit. Files saved temporarily on your device are not a separate backup.
| Platform | Setup |
|---|---|
| Linux | Desktop drive access requires additional system software. Choose an empty folder for the drive. This workflow has been tested on Linux. |
| macOS | Desktop drive access requires additional system software. Choose an empty folder. This feature is still in preview on Mac. |
| Windows | Desktop drive access requires additional system software and may not be available in every build. Check your installed version before relying on it. |
| Android | Supported builds can show Airmsh drives in your phone’s file picker. Check the installed app version. |
| iPhone / iPad | Supported builds can show Airmsh drives in Files. Check the installed app version. |
On a phone, there is no folder path to enter. Open the phone’s Files app or file picker after attaching. Store releases may not yet include every AirFS feature, so check the version installed on your device.
Drives using your own storage still need the owner’s computer online. If Attach is missing or unavailable, check your installed app version before retrying.
05 / RECOVER
Inspect history. Restore deliberately.
Drive admins can browse saved versions, restore an earlier version, or fork the drive for separate work. Changes that have not finished saving will not appear in history.
- In Files, select the drive, then open History → Older versions and load the versions.
- Review the selected version and stop active editing. Detach the drive before restoring or forking.
- Choose Restore this version, or create a fork if you do not want to replace the current drive.
- Check the result from another authorized device.
History and extra copies use storage. They are not a substitute for an independent backup.
06 / CHECK
Verify the drive and the permission boundary.
- Create a small test file. Open it from a second approved device after it finishes saving.
- Check that read-only users cannot edit, hidden folders remain hidden, and removed users can no longer open the drive.
- Try reconnecting, detaching, and editing on the devices you plan to use.
- For your own storage, check that sharing still works while the owner’s computer stays online.
- Check your provider’s storage and transfer charges separately.
If the drive does not appear
Check the installed app version, whether drive access is available on that device, organization membership, and the recipient’s folder permissions.
If files are missing or stale
Wait for saving to finish and refresh the drive. For your own storage, keep the owner’s computer online and use Sync server index to check for errors.
If attachment or writes fail
Check the required desktop software, storage account access, whether the owner’s computer is online, and whether someone else is editing. Do not delete files that have not finished saving.
Need help with your package? Use Downloads and the community. For the private device connection itself, follow the infrastructure setup guide.