Server Configuration

The following are server-specific configuration settings. They are placed in a top-level "server" key, like this:

// config.jwcc
{
  "server": {
    // ... server properties here ...
  }
}
server.download
Type:
object
Default:
null

The server.download setting is a store locator that specifies a store that the server will download store objects and realizations from when the server receives a request to realize a derivation output it does not have in its local store before attempting to run its builder program.

server.upload
Type:
object
Default:
null

The server.upload setting is a store locator that specifies a store that the server will upload store objects and realizations to after the server successfully runs a builder program.

server.signingKeyFiles
Type:
array of strings
Default:
[]

The server.signingKeyFiles setting is an array of paths to JSON files that contain private signing keys. server.signingKeyFiles settings are merged across all configuration files. zb serve will sign each realization with every key after it successfully runs a builder program and before it uploads to the store in server.upload.

Each signing key file holds a JSON object with the following properties:

Name

Type

Description

format

string

Only "ed25519" is defined at the moment

key

string

Base64-encoded private key data

Signing keys can be generated with the zb key generate command.