goofys | Zata Docs

goofys mounts a Zata bucket as a folder on Linux. It is fast for reading and writing whole files, but it is not a full disk — see What goofys cannot do. Its last release is from 2020. The examples use Indore (https://idr01.zata.ai); for a bucket in Mumbai, use https://bom01.zata.ai.

Tested with goofys 0.24.0 (Linux x86_64) on Zata in October 2026.

Before you start

A bucket — see Create a bucket.
An access key from the same region as the bucket — see Access keys.
A Linux machine (x86_64).

Connection settings

Setting	Value
Endpoint (`--endpoint`)	`https://idr01.zata.ai` for Indore, `https://bom01.zata.ai` for Mumbai
Keys	in `~/.aws/credentials` — the key must be from the same region as the bucket
Path-style	used by default — no option needed

Set up goofys

Install goofys

Download the ready-made program:

curl -sL -o goofys https://github.com/kahing/goofys/releases/download/v0.24.0/goofys
chmod +x goofys
sudo mv goofys /usr/local/bin/
goofys --version

Save your keys

Open the credentials file:

mkdir -p ~/.aws
nano ~/.aws/credentials

Add your keys:

~/.aws/credentials

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

Then make the file private:

chmod 600 ~/.aws/credentials

Mount the bucket

Replace my-bucket with your bucket name:

mkdir -p ~/zata
goofys --endpoint https://idr01.zata.ai my-bucket ~/zata

To mount only one folder of the bucket, add it after a colon:

goofys --endpoint https://idr01.zata.ai my-bucket:folder ~/zata

Test it

echo "Hello from goofys" > ~/zata/hello.txt
ls -l ~/zata

The file hello.txt also appears in your bucket in the Zata console under Buckets.

Unmount

fusermount -u ~/zata

What goofys cannot do

Action	On goofys
Add to the end of a file (`>>`, log files)	Not supported — a file must be written in one go.
Change part of an existing file (databases, editing in place)	Not supported.
Symlinks and hard links	Not supported.
`chmod` / `chown`	Ignored. Set the owner and mode for the whole mount with `--uid`, `--gid`, `--file-mode` and `--dir-mode`.
Local cache	Only with the separate `catfs` tool (`--cache`).

If you need these, use s3fs or rclone mount (see rclone on Linux). Both are slower but behave more like a normal disk.

Troubleshooting

Problem	Fix
`Operation not supported` when saving a file	The app adds to or edits the file in place. goofys cannot do that — see the table above.
Access denied, or the mount fails	Check `~/.aws/credentials` and that the key can use this bucket. Run goofys in the foreground with `-f --debug_s3` to see the error.
Bucket not found	Use the endpoint of the region the bucket is in (`idr01` or `bom01`).
Other users cannot see the files	Add `-o allow_other`. As a normal user, this needs `user_allow_other` in `/etc/fuse.conf`.

For other errors, see Access denied and Endpoint and region.