Scroll to navigation

BUILDBOX-CASD(1) User Commands BUILDBOX-CASD(1)

NAME

buildbox-casd - buildbox-casd

SYNOPSIS

buildbox-casd

DESCRIPTION

Display usage and exit.
Print version information and exit. [optional]
URL for all services [optional]
Instance for all services [optional]
Server TLS certificate for all services (PEM-encoded) [optional]
Client private TLS key far all services (PEM-encoded) [optional]
Client TLS certificate for all services (PEM-encoded) [optional]
Authentication token for all services (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Default access token refresh timeout [optional]
Use GoogleAPIAuth for all services [optional]
Credential helper executable for all services [optional]
Retry limit for gRPC errors for all services [optional]
Retry delay for gRPC errors for all services [optional]
gRPC status code(s) as string(s) to retry on for all services, e.g. 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for all services (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for all services, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for all services (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for all services (valid options are 'round_robin' and 'grpclb') [optional]
URL for the CAS service [optional]
Name of the CAS instance [optional]
Server TLS certificate for CAS (PEM-encoded) [optional]
Client private TLS key for CAS (PEM-encoded) [optional]
Client TLS certificate for CAS (PEM-encoded) [optional]
Authentication token for CAS (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Access token refresh timeout for CAS service [optional]
Use GoogleAPIAuth for CAS service [optional]
Credential helper executable for CAS service [optional]
Retry limit for gRPC errors for CAS service [optional]
Retry delay for gRPC errors for CAS service [optional]
gRPC status code(s) as string(s) to retry on for CAS service e.g., 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for CAS service (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for CAS service, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for CAS service (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for CAS service (valid options are 'round_robin' and 'grpclb') [optional]
[Deprecated] Use --local-server-instance. [optional]
Create an additional local CAS server instance (useful when --cas-remote is specified). [optional]
Set a custom digest function. Default: SHA256 Supported functions: SHA512, SHA384, SHA256, SHA1, MD5 [optional]
URL for the Action Cache service [optional]
Name of the Action Cache instance [optional]
Server TLS certificate for Action Cache (PEM-encoded) [optional]
Client private TLS key for Action Cache (PEM-encoded) [optional]
Client TLS certificate for Action Cache (PEM-encoded) [optional]
Authentication token for Action Cache (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Access token refresh timeout for Action Cache service [optional]
Use GoogleAPIAuth for Action Cache service [optional]
Credential helper executable for Action Cache service [optional]
Retry limit for gRPC errors for Action Cache service [optional]
Retry delay for gRPC errors for Action Cache service [optional]
gRPC status code(s) as string(s) to retry on for Action Cache service e.g., 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for Action Cache service (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for Action Cache service, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for Action Cache service (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for Action Cache service (valid options are 'round_robin' and 'grpclb') [optional]
URL for the Remote Asset service [optional]
Name of the Remote Asset instance [optional]
Server TLS certificate for Remote Asset (PEM-encoded) [optional]
Client private TLS key for Remote Asset (PEM-encoded) [optional]
Client TLS certificate for Remote Asset (PEM-encoded) [optional]
Authentication token for Remote Asset (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Access token refresh timeout for Remote Asset service [optional]
Use GoogleAPIAuth for Remote Asset service [optional]
Credential helper executable for Remote Asset service [optional]
Retry limit for gRPC errors for Remote Asset service [optional]
Retry delay for gRPC errors for Remote Asset service [optional]
gRPC status code(s) as string(s) to retry on for Remote Asset service e.g., 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for Remote Asset service (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for Remote Asset service, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for Remote Asset service (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for Remote Asset service (valid options are 'round_robin' and 'grpclb') [optional]
URL for the Execution service [optional]
Name of the Execution instance [optional]
Server TLS certificate for Execution (PEM-encoded) [optional]
Client private TLS key for Execution (PEM-encoded) [optional]
Client TLS certificate for Execution (PEM-encoded) [optional]
Authentication token for Execution (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Access token refresh timeout for Execution service [optional]
Use GoogleAPIAuth for Execution service [optional]
Credential helper executable for Execution service [optional]
Retry limit for gRPC errors for Execution service [optional]
Retry delay for gRPC errors for Execution service [optional]
gRPC status code(s) as string(s) to retry on for Execution service e.g., 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for Execution service (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for Execution service, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for Execution service (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for Execution service (valid options are 'round_robin' and 'grpclb') [optional]
Name of proxy instance. Multiple values of PROXY_INSTANCE[:REMOTE_INSTANCE] can be specified. If REMOTE_INSTANCE exists, the proxy instance uses it for remote connections, overriding --*instance options. [optional]
Bind to address:port or UNIX socket in unix:path. Multiple addresses can be specified. [optional]
If binding to a UNIX socket, update its group ownership [optional]
If binding to a UNIX socket, update its mode in octal format e.g. 0775 [optional]
The minimum allowed time in seconds between keepalive pings from clients [optional]
Maximum local cache size (e.g., 50G or 2T) [optional]
Local cache size to retain on LRU expiry, either as absolute size or as percentage of `quota-high` [optional, default = "50%"]
Reserved disk space (headroom left when `quota-high` gets automatically reduced) [optional, default = "2G"]
Do not expire blobs created or used in the current session [optional, default = false]
Absolute path to runner executable to enable the local execution service [optional]
Arguments to pass buildbox-run when buildbox-casd runs a job [optional]
Maximum number of jobs to run concurrently for local execution [optional, default = 4]
Maximum queue length for local execution in proxy instance [optional]
Fallback to local execution if the remote server is unable to schedule the clients request (e.g. due to service throttling). Fallback executions are excluded from the --exec-hybrid-queue-limit value. Requires that --buildbox-run is set. [optional, default = false]
Cache local actions with non-zero exit code [optional, default = true]
Number of seconds to cache the results of FindMissingBlobs() calls when in proxy mode [optional, default = 0]
Attempt to move files into the CAS when a LocalCAS capture request has its `move_files` flag set. This will avoid a copy only when a file is in the same filesystem as the LOCAL_CACHE directory and owned by the user that is running casd. NOTE: Only enable if clients can be trusted to not break the consistency of the storage. [optional, default = false]
Metrics Mode: --metrics-mode=MODE - options for MODE are udp://<hostname>:<port> file:///path/to/file stderr [optional]
Metrics publishing interval [optional, default = 15]
Prefix of metric names [optional, default = "buildboxcasd"]
Specifies if casd should update the remote CAS with local build artifacts [optional]
Store object files with writable mode (644) [optional]
The number of threads to hash files to digests. Default=min(hardware-concurrency,16) [optional]
The number of threads for proxy CAS instances to upload or download blobs from/to remote CAS. For now, only upload is parallelized.Default=min(hardware-concurrency*2,32) [optional]
Forcefully terminate pending requests the specified number of seconds after requesting shutdown (SIGINT/SIGTERM) [optional]
A list of _absolute paths_ to executables that are allowed to run before staged directories are unstaged. [optional]
Number of seconds to cache the results of GetActionResult() validations when in proxy mode [optional, default = 0]
Log level (debug, error, info, trace, warning) [optional, default = "error"]
Set log level to 'debug' [optional]
POSITIONAL [required]
March 2026 buildbox-casd 1.4.0