Blixt Documentation v2.11

The BlixtFS app for MacOS

A native BlixtFS app for MacOS is in development. The app mounts buckets directly in Finder without Docker. It requires MacOS 26 or later and will be distributed through the Mac App Store. Until it is available, use MacOS Docker.

Setting up

The first time the app opens, its setup assistant takes you from a fresh install to your files in Finder:

  1. Your storage. Pick a cloud. Clouds whose credentials are already on the Mac are marked Found: AWS and Oracle profiles, a gcloud application-default sign-in, an az login sign-in.
  2. Connect. Use the credentials found, or enter keys. Test Connection tries them before anything is saved, and when they don’t work says why, with a link to the page that explains the fix.
  3. Choose buckets. Tick the buckets to show, and mark any that BlixtFS should never change as Read Only. Keys that may read a bucket but not list them can check one by name instead.
  4. Sample data. Public buckets that need no account: the BlixtFS sample files, and Google’s Quick, Draw! drawings. You can skip the steps above and start with these alone.
  5. Where your files live. Choose the folder, which is ~/BlixtFS unless you choose another. Choose whether to show it whenever BlixtFS starts, and whether to open BlixtFS when you log in.

Inside the folder, each cloud has a folder, and each bucket a folder inside it: ~/BlixtFS/aws/my-bucket. To add another cloud later, choose Add Cloud… from the menu bar icon; Configuration Wizard… starts over. Everything the assistant sets can also be changed in Configuration.

The credential pages under Cloud credentials explain each cloud’s credentials.