caterva2-server.sample.toml

# Example configuration for a standalone server
#
# It's possible to run only the server. Then the configuration has only a
# section for the server. And maybe another one for the client.

# The server section must define:
#
# - listen: where the server listens to (a unix socket or a host/port) (default: localhost:8000)
# - urlbase: the base url users will use to reach the server (default: http://localhost:8000)
# - quota: if defined, it will limit the disk usage (default: 0, no limit)
# - maxusers: if defined, it will limit the number of users (default: 0, no limit)
# - login: if true, users will need to authenticate (default: true)
# - register: if true, users will be able to register (default: false)
# - publish_root: if defined, where an array filled a chunk at a time is copied
#   once every one of its chunks has landed.  An fsspec URL of a directory
#   ("s3://bucket/prefix", "file:///srv/published"); a dataset names the key it
#   wants underneath it and nothing above it.  Credentials for it are the
#   server's own.  Unset (the default) means such arrays are simply not published.
# - peer_cache_quota: maximum total size of the optional C2Cache peer cache
#   (default: "1G"). C2Cache ships inside Caterva2 and remains inactive unless
#   one or more [[server.peer]] entries are configured.
#
[server]
# listen = "_caterva2/state/uvicorn.socket"  # server supports listening from UNIX sockets
listen = "localhost:8000"
urlbase = "http://localhost:8000"
quota = "10G"
maxusers = 5
register = true  # allow users to register
# publish_root = "s3://a-bucket/published"
# peer_cache_quota = "1G"

# Mount a remote Caterva2 server's locally owned @public root as @labb.  This
# activates the bundled C2Cache provider.  Repeat the table to mount more peers.
# An optional per-peer cache_quota further bounds this peer within the pool.
# [[server.peer]]
# name = "labb"
# urlbase = "http://server-b:8000"
# cache_quota = "500M"