ETM-Schurig/powersync-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
powersync-docs/docs/api/systeme/configuration.md
Patrick Schurig 325409dd3f feat(i18n): prose traduite DE/EN et référence régénérée en anglais 
82 pages .de.md et 82 .en.md. La volumétrie explique la forme : 95 % du volume
est GÉNÉRÉ (74 013 mots contre 3 506 rédigés, mesuré sur 107 pages). On ne
traduisait donc pas 77 500 mots — on traduit la prose, et le vocabulaire des
générateurs fait le reste.

Prose traduite à la main : accueil, installation (4), fonctionnalités (4),
tarifs, référence, dépannage, FAQ, intégrations (2), api/index, et les 6 fiches
appareils qui portent une vraie prose + compatibilite.md. Les blocs générés ne
sont JAMAIS recopiés dans une traduction : le script de pose les reprend
verbatim du fichier français via des placeholders, pour qu'une traduction ne
puisse pas désynchroniser un bloc généré.

Les 49 fiches légères n'ont rien à traduire : leur tagline vient d'amont et est
DÉJÀ en anglais (« Connects nymea to powerfox. »). Constat, pas renoncement.

Localisation ≠ traduction, et tarifs.md en est l'exemple à connaître : la
version FR parle de Tempo et du signal RTE, la DE de §14a EnWG et de SMARD,
l'EN des deux. Ce ne sont pas des traductions l'une de l'autre, et c'est
volontaire — les signaux tarifaires sont nationaux. Aucune des deux n'est
annoncée comme livrée : les deux sont Roadmap, et les pages le disent.

Référence régénérée : en-têtes et libellés en anglais (Field/Type/Notes,
Supported models, Settings, Read-only, Brand / Model…). Conséquence assumée et
signalée : les pages FR en ligne changent aussi.

README.md (il était VIDE) : la règle du 95 % généré en tête, la frontière de
décision du multi-langue avec sa mesure, pourquoi SCAFFOLD existe, et le piège
--strict/navigation.instant.

TODO : multi-langue clos, et trois points ouverts qui en restent — les tagline
vivent dans les meta.json de 5 autres dépôts (forme à ajouter : tagline_de /
tagline_en), les stubs traduits restent des stubs (la dette éditoriale a triplé
en surface, pas en fond), api/types.md n'a pas besoin de variante. Le P1
openmeteo est corrigé sur constat : il EST dans PORTING_STATUS depuis, et une
ligne commentée contradictoire y traîne encore.

Vérifié : mkdocs build --strict vert sur les trois langues, 322 pages HTML,
contenu traduit relu dans le HTML produit, et les deux générateurs rendent
« Doc à jour » en --check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-13 06:39:20 +02:00

18 KiB
Raw Permalink Blame History

Configuration

Methods

Configuration.CreateAndDownloadBackup

ADMIN

Create a backup of the current configuration and generate a download entry for the dedicated transfer connection.

Parameters:

No parameters.

Returns:

Field Type Notes
configurationError ConfigurationError
downloadId String
fileName String
size Int

Configuration.CreateBackup

ADMIN

Create a backup of the current configuration. It will be stored in the configured destination directory. Also the maxCout configuration will be considered.

Parameters:

No parameters.

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteBackupFile

ADMIN

Delete an existing configuration backup file.

Parameters:

Field Type Notes
fileName String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteMqttPolicy

ADMIN

Delete a MQTT policy from the broker.

Parameters:

Field Type Notes
clientId String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteMqttServerConfiguration

ADMIN

Delete a MQTT Server interface of the server.

Parameters:

Field Type Notes
id String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteTcpServerConfiguration

ADMIN

Delete a TCP interface of the server. Note: if you are deleting the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
id String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteTunnelProxyServerConfiguration

ADMIN

Delete a Tunnel Proxy Server interface of the server. Note: if you are deleting the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
id String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteWebServerConfiguration

ADMIN

Delete a WebServer interface of the server.

Parameters:

Field Type Notes
id String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DeleteWebSocketServerConfiguration

ADMIN

Delete a WebSocket Server interface of the server. Note: if you are deleting the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
id String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.DownloadBackupFile

ADMIN

Generate a download entry for an existing configuration backup file.

Parameters:

Field Type Notes
fileName String

Returns:

Field Type Notes
configurationError ConfigurationError
downloadId String optional
fileName String optional
size Int optional

Configuration.GetAvailableLanguages

PUBLIC

Returns a list of locale codes available for the server. i.e. en_US, de_AT

Parameters:

No parameters.

Returns:

Field Type Notes
languages String[]

Configuration.GetBackupFiles

ADMIN

Get the list of configuration backup files from the configured destination directory.

Parameters:

No parameters.

Returns:

Field Type Notes
backupFiles BackupFile[]

Configuration.GetConfigurations

PUBLIC

Get all configuration parameters of the server.

Parameters:

No parameters.

Returns:

Field Type Notes
backupConfigurations {'autoBackupEnabled': 'Bool', 'autoBackupInterval': 'Int', 'destinationDirectory': 'String', 'maxCount': 'Uint'}
basicConfiguration {'d:language': 'String', 'd:location': {'latitude': 'Double', 'longitude': 'Double', 'name': 'String'}, 'd:serverTime': 'Uint', 'd:timeZone': 'String', 'debugServerEnabled': 'Bool', 'serverName': 'String', 'serverUuid': 'Uuid'}
mqttServerConfigurations ServerConfiguration[]
tcpServerConfigurations ServerConfiguration[]
tunnelProxyServerConfigurations TunnelProxyServerConfiguration[]
webServerConfigurations WebServerConfiguration[]
webSocketServerConfigurations ServerConfiguration[]

Configuration.GetMqttPolicies

ADMIN

Get all MQTT broker policies.

Parameters:

No parameters.

Returns:

Field Type Notes
mqttPolicies MqttPolicy[]

Configuration.GetMqttServerConfigurations

ADMIN

Get all MQTT Server configurations.

Parameters:

No parameters.

Returns:

Field Type Notes
mqttServerConfigurations ServerConfiguration[]

Configuration.GetTimeZones

PUBLIC

Get the list of available timezones.

Parameters:

No parameters.

Returns:

Field Type Notes
timeZones String[]

Configuration.RestoreBackupFile

ADMIN

Restore an existing configuration backup file. Clients should warn the user before calling this method because the current configuration data will be wiped, the server will restart immediately afterwards and it will come back up using the restored backup.

Parameters:

Field Type Notes
fileName String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetBackupConfiguration

ADMIN

Set the backup configuration. The destination directory is the location where the archives will be saved, the maxCount is the number of backups which will be kept. If maxCount is 0, all backups will be kept. The autoBackupEnabled property controls periodic configuration backups and autoBackupInterval defines the interval in hours.

Parameters:

Field Type Notes
autoBackupEnabled Bool
autoBackupInterval Int
destinationDirectory String
maxCount Uint

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetDebugServerEnabled

ADMIN

Enable or disable the debug server.

Parameters:

Field Type Notes
enabled String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetLanguage

ADMIN

Sets the server language to the given language. See also: "GetAvailableLanguages"

Parameters:

Field Type Notes
language String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetLocation

ADMIN

Sets the server location.

Parameters:

Field Type Notes
location {'latitude': 'Double', 'longitude': 'Double', 'name': 'String'}

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetMqttPolicy

ADMIN

Configure a MQTT broker policy. If the ID is an existing one, the existing policy will be modified, otherwise a new one will be added.

Parameters:

Field Type Notes
policy MqttPolicy

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetMqttServerConfiguration

ADMIN

Configure a MQTT Server interface on the MQTT broker. If the ID is an existing one, the existing config will be modified, otherwise a new one will be added. Setting authenticationEnabled to true will require MQTT clients to use credentials set in the MQTT broker policies.

Parameters:

Field Type Notes
configuration ServerConfiguration

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetServerName

ADMIN

Set the name of the server. Default is nymea.

Parameters:

Field Type Notes
serverName String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetTcpServerConfiguration

ADMIN

Configure a TCP interface of the server. If the ID is an existing one, the existing config will be modified, otherwise a new one will be added. Note: if you are changing the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
configuration ServerConfiguration

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetTimeZone

ADMIN

Set the time zone of the server. See also: "GetTimeZones"

Parameters:

Field Type Notes
timeZone String

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetTunnelProxyServerConfiguration

ADMIN

Configure a Tunnel Proxy Server interface of the server. If the ID is an existing one, the existing config will be modified, otherwise a new one will be added. Note: if you are changing the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
configuration TunnelProxyServerConfiguration

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetWebServerConfiguration

ADMIN

Configure a WebServer interface of the server. If the ID is an existing one, the existing config will be modified, otherwise a new one will be added.

Parameters:

Field Type Notes
configuration WebServerConfiguration

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.SetWebSocketServerConfiguration

ADMIN

Configure a WebSocket Server interface of the server. If the ID is an existing one, the existing config will be modified, otherwise a new one will be added. Note: if you are changing the configuration for the interface you are currently connected to, the connection will be dropped.

Parameters:

Field Type Notes
configuration ServerConfiguration

Returns:

Field Type Notes
configurationError ConfigurationError

Configuration.UploadAndRestoreBackup

ADMIN

Create an upload session for a configuration backup archive. The uploaded file will be stored temporarily under /tmp, the current configuration will be wiped after the upload finishes and the server will restart immediately using the restored backup. Clients should warn the user before calling this method because all current configuration data will be lost.

Parameters:

Field Type Notes
fileName String
size Int

Returns:

Field Type Notes
configurationError ConfigurationError
fileName String optional
size Int optional
transferId String optional
transferToken String optional

Notifications

Configuration.BackupConfigurationChanged

Emitted whenever the backup configuration changes.

Parameters:

Field Type Notes
autoBackupEnabled Bool
autoBackupInterval Int
destinationDirectory String
maxCount Uint

Configuration.BackupFilesChanged

Emitted whenever the list of backup files changes.

Parameters:

Field Type Notes
backupFiles BackupFile[]

Configuration.BasicConfigurationChanged

Emitted whenever the basic configuration of this server changes.

Parameters:

Field Type Notes
basicConfiguration {'d:language': 'String', 'd:location': {'latitude': 'Double', 'longitude': 'Double', 'name': 'String'}, 'd:serverTime': 'Uint', 'd:timeZone': 'String', 'debugServerEnabled': 'Bool', 'serverName': 'String', 'serverUuid': 'Uuid'}

Configuration.MqttPolicyChanged

Emitted whenever a MQTT broker policy is changed.

Parameters:

Field Type Notes
policy MqttPolicy

Configuration.MqttPolicyRemoved

Emitted whenever a MQTT broker policy is removed.

Parameters:

Field Type Notes
clientId String

Configuration.MqttServerConfigurationChanged

Emitted whenever the MQTT broker configuration is changed.

Parameters:

Field Type Notes
mqttServerConfiguration ServerConfiguration

Configuration.MqttServerConfigurationRemoved

Emitted whenever a MQTT server configuration is removed.

Parameters:

Field Type Notes
id String

Configuration.TcpServerConfigurationChanged

Emitted whenever the TCP server configuration changes.

Parameters:

Field Type Notes
tcpServerConfiguration ServerConfiguration

Configuration.TcpServerConfigurationRemoved

Emitted whenever a TCP server configuration is removed.

Parameters:

Field Type Notes
id String

Configuration.TunnelProxyServerConfigurationChanged

Emitted whenever the tunnel proxy server configuration changes.

Parameters:

Field Type Notes
tunnelProxyServerConfiguration TunnelProxyServerConfiguration

Configuration.TunnelProxyServerConfigurationRemoved

Emitted whenever a tunnel proxy server configuration is removed.

Parameters:

Field Type Notes
id String

Configuration.WebServerConfigurationChanged

Emitted whenever the web server configuration changes.

Parameters:

Field Type Notes
webServerConfiguration WebServerConfiguration

Configuration.WebServerConfigurationRemoved

Emitted whenever a Web server configuration is removed.

Parameters:

Field Type Notes
id String

Configuration.WebSocketServerConfigurationChanged

Emitted whenever the web socket server configuration changes.

Parameters:

Field Type Notes
webSocketServerConfiguration ServerConfiguration

Configuration.WebSocketServerConfigurationRemoved

Emitted whenever a WebSocket server configuration is removed.

Parameters:

Field Type Notes
id String