Rust uses environment variables for a number of configuration options. Some of these include:
variable value description
RUST_LOG debug , info , warn , error minimum Rust error logging level RUST_TEST_THREADS 1 maximum number of concurrent threads for testing.
In addition, Sync server configuration options can either be specified as environment variables (prefixed with SYNC_ *) or in a configuration file using the --config option.
For example the following are equivalent:
$ SYNC_HOST=0.0.0.0 SYNC_MASTER_SECRET="SuperSikkr3t" SYNC_SYNCSTORAGE__DATABASE_URL=mysql://scott:tiger@localhost/syncstorage cargo run
$ cat syncstorage.local.toml
host = "0.0.0.0"
master_secret = "SuperSikkr3t"
[syncstorage]
database_url = "mysql://scott:tiger@localhost/syncstorage"
$ cargo run -- --config syncstorage.local.toml
Options can be mixed between environment variables and configuration. Environment variables have higher precedence.
The following configuration options are available.
Env Var Default Value Description
127.0.0.1 Host address to bind the server to 8000 Server port to bind to None, required Secret used to derive auth secrets dev Environment name (“dev”, “stage”, “prod”) false Enable human-readable logs None HTTP keep-alive header value in seconds 512 The maximum number of blocking threads in the worker threadpool. This threadpool is used by Actix-web to handle blocking operations.
Env Var Default Value Description
* Allowed origins for CORS requests 1728000 CORS preflight cache seconds (20 days) [“DELETE”, “GET”, “POST”, “PUT”] Allowed methods
Env Var Default Value Description
mysql://root@127.0.0.1/syncstorage Database connection URL 10 Max database connections 30 Pool timeout in seconds None Max connection age in seconds None Max idle time in seconds 30 How often, in seconds, a background task runs to evict idle database connections (Spanner only) false Send leader-aware headers to Spanner None Spanner emulator host (e.g., localhost:9010)
Env Var Default Value Description
2,621,440 Max BSO payload size per request 100 Max BSO count per request 2,621,440 Max individual BSO payload size 2,625,536 Max Content-Length for requests 262,144,000 Max BSO payload size per batch 10,000 Max BSO count per batch 2,147,483,648 Max storage quota per user (2 GB)
Env Var Default Value Description
true Enable syncstorage service false Enable quota tracking (Spanner only) false Enforce quota limits (Spanner only) true Enable Glean telemetry syncstorage StatsD metrics label prefix
Env Var Default Value Description
mysql://root@127.0.0.1/tokenserver Tokenserver database URL 10 Max tokenserver DB connections 30 Pool timeout in seconds
Env Var Default Value Description
false Enable tokenserver service false Run DB migrations on startup 3600 Token TTL (1 hour)
Env Var Default Value Description
api-accounts.stage.mozaws.net FxA email domain https://oauth.stage.mozaws.net FxA OAuth server URL 10 OAuth request timeout in seconds secret Secret for hashing metrics to maintain anonymity None Primary JWK key type (e.g., “RSA”) None Primary JWK algorithm (e.g., “RS256”) None Primary JWK key ID None Primary JWK creation timestamp None Primary JWK use (e.g., “sig”) None Primary JWK modulus (RSA public key component) None Primary JWK exponent (RSA public key component) None Secondary JWK (same structure as primary)
Env Var Default Value Description
localhost StatsD server hostname 8125 StatsD server port false Include hostname in metrics tags