Skip to content

Configuration

Generated from the flag definitions in server/cmd/lasboltd/config.go and the lasboltd --help output. Do not edit.

lasboltd reads its settings from flags and from environment variables. Each flag has one variable. A flag on the command line wins over the variable.

Flags that the text marks “For tests” tune timing for the test suites. Leave them at their defaults on a real server.

FlagEnvironment variableDefaultMeaning
--addrLASBOLT_ADDR:8080, dev: 127.0.0.1:8080listen address
--allow-registrationLASBOLT_ALLOW_REGISTRATION=1offlet more than the first user register
--approval-waitLASBOLT_APPROVAL_WAIT20slongest wait of one read call for a per-use approval; below –http-write-timeout. For tests
--backup-dirLASBOLT_BACKUP_DIR<data-dir>/backupsbackup directory
--backup-identityLASBOLT_BACKUP_IDENTITY(none)private key file to open sealed backups
--backup-intervalLASBOLT_BACKUP_INTERVAL24htime between backups, 0 turns backups off
--backup-keepLASBOLT_BACKUP_KEEP14number of backups to keep, 0 keeps all
--backup-recipientLASBOLT_BACKUP_RECIPIENT(none)public key file: seal backups to it
--ctl-socketLASBOLT_CTL_SOCKET(none)path of the control socket for lasboltctl, mode 0600, for example /run/lasbolt/ctl.sock; empty turns it off
--data-dirLASBOLT_DATA_DIR./data, dev: ./.devdata directory
--devLASBOLT_DEV=1offdev mode
--device-poll-intervalLASBOLT_DEVICE_POLL_INTERVAL5spoll interval of a device-code login, also the slow_down step. For tests
--e2e-idleLASBOLT_E2E_IDLE15midle time after which a browser tab loses its E2E unlock. For tests
--http-read-timeoutLASBOLT_HTTP_READ_TIMEOUT30sHTTP read timeout of one request. For tests
--http-write-timeoutLASBOLT_HTTP_WRITE_TIMEOUT60sHTTP write timeout of one response. For tests
--key-fileLASBOLT_KEY_FILE(none)file with 32 raw key bytes
--key-providerLASBOLT_KEY_PROVIDERpassphrasepassphrase, file or insecure-static
--peer-list-max-ageLASBOLT_PEER_LIST_MAX_AGE168hlongest age of a peer list on a device
--peer-stunLASBOLT_PEER_STUNnonepublic STUN server host:port that devices may ask; repeatable
--peer-syncLASBOLT_PEER_SYNConon or off: devices of one user sync directly with each other; off turns the peer registry and the relay push off
--peer-udpLASBOLT_PEER_UDP7849, dev: loopback onlyUDP port that tells a device its public address, a port, host:port or off
--peer-udp-publicLASBOLT_PEER_UDP_PUBLICthe bound portUDP port that devices are told, when a NAT or port map changes it
--public-urlLASBOLT_PUBLIC_URL(none)public origin of this server, such as https://vault.example.org; lasboltctl uses it in invitation links
--sse-heartbeatLASBOLT_SSE_HEARTBEAT25stime between SSE heartbeats. For tests
--sse-write-windowLASBOLT_SSE_WRITE_WINDOW30stime that one SSE write may take; each write moves the deadline. For tests
--tmp-dirLASBOLT_TMP_DIRthe directory of the filedirectory for temporary copies in backup verify
--trusted-proxyLASBOLT_TRUSTED_PROXY(none)CIDR range of a trusted reverse proxy; repeatable
--unseal-passphrase-fileLASBOLT_UNSEAL_PASSPHRASE_FILE(none)file with the unseal passphrase
--user-purge-intervalLASBOLT_USER_PURGE_INTERVAL1htime between two runs of the job that removes deleted accounts after their grace period. For tests

For a guide to the settings that matter on a real server, see Configuration in the server section.