How to Deploy SeaweedFS Enterprise

1. Download

  • Download the binary from the official repository.
  • Fetch the container via docker pull chrislusf/seaweedfs-enterprise.

2. License

  • Free if less than 25TB — no license required.
  • For larger deployments, request a license from support at seaweedfs dot com.

3. Basic Setup

  • All components are started the same way as the open source version except weed master or weed server.

  • Place your license file (e.g., seaweed-license.json) in a default location on your server:

    • ./seaweed-license.json
    • $HOME/.seaweedfs/seaweed-license.json
    • /usr/local/etc/seaweedfs/seaweed-license.json
    • /etc/seaweedfs/seaweed-license.json

  • Or specify the license file with the -license flag:

    weed master -license=/path/to/seaweed-license.json ...
weed server -license=/path/to/seaweed-license.json ...

# start other components as usual
weed volume ...
weed filer ...

  • Alternatively, you can set the SEAWEED_LICENSE environment variable to the license file path:

    export SEAWEED_LICENSE=/path/to/seaweed-license.json
weed server ...
weed master ...
weed volume ...
weed filer ...

  • If the license file is updated (e.g., upon renewal), it will be automatically picked up in a few minutes.

4. Admin UI Authentication

SeaweedFS Enterprise supports two admin UI sign-in models:

  • Local credentials: configure [admin] and optional [admin.readonly] in security.toml
  • OIDC login: configure [admin.oidc] to enable authorization code login through your identity provider

If both are configured, the admin login page offers both methods.

For OIDC setup details, role mapping, and callback URL examples, see:

➡️ Admin UI OIDC Login

Need help? For deployment or migration support, contact: support at seaweedfs dot com