Administration

A self-hosted deployment is administered with the swiftfs command, run with the same environment as the server (for example with docker exec).

Accounts

Accounts own buckets and access keys. Give each application or customer its own.

swiftfs admin account create acme
swiftfs admin account list

Access keys

swiftfs admin key create --account acme --description "web app"
swiftfs admin key create --account acme --bucket uploads --bucket thumbnails --expires 2160h
swiftfs admin key create --account acme --bucket reports --read-only --description "BI export"
swiftfs admin key create --account acme --policy-file scope.json
swiftfs admin key list --account acme
swiftfs admin key revoke SWKEYID

The secret is printed once. --bucket limits a key to buckets (with --read-only, to reading them); --policy-file gives any scope as a policy document without principals.

Quotas

swiftfs admin account limits acme                                  # show
swiftfs admin account limits acme --storage 50GiB --buckets 20 --objects 1000000
swiftfs admin account limits acme --storage none                   # remove one

Over a quota, uploads and new buckets are refused with 403 QuotaExceeded. Reads and deletes keep working. Changes made with docker exec reach a running server within SWIFTFS_QUOTA_REFRESH.

Usage

swiftfs admin usage --account acme                                 # this month so far
swiftfs admin usage --account acme --from 2026-09-01 --to 2026-10-01

Average storage, byte-hours, current storage, requests by class, and data in and out, per bucket: the same records SwiftFS Cloud bills from.

Status

swiftfs admin status

Health checks with their errors, the disk holding the data, what every account stores, multipart uploads in progress, any corrupt data, and every background job's last run and last error.