Skip to main content

Set general installation settings

PUT 

/settings/general

Required role: admin. Only an account or token with the admin role can call this operation.

Example request
curl --request PUT \
--header "Authorization: Bearer $HOSERVA_TOKEN" \
--header "Content-Type: application/json" \
--data @body.json \
"https://$HOSERVA_HOST:8008/api/v1/settings/general"

Persists hostname, timezone and/or the backup passphrase. Each field is optional: omitted leaves that value unchanged. An empty hostname clears a previously set hostname. backupPassphrase is write-only and never echoed back — skipping it during onboarding is valid.

Request​

Responses​

The updated general settings.