Skip to main content
Version: v12.x - Umbraco 12

uSync.Publisher Config

for uSync 9 and 10 the majority of the uSync publisher config now lives in the Database, and can be synced between your servers via the dashboard.

AppId/AppKey​

For your servers to communicate securely they will need to have a shared AppId and AppKey, these values have to be placed in the appsettings.json file on each server.

tip

When you first open up the uSync.Publisher dashboard, uSync will prompt you to create an AppId and AppKey. you can cut and paste the JSON from that dialog box directly into your appsettings.json file.

{
"uSync": {
"Publisher": {
"Settings": {
"IncomingEnabled": true,
"AppId": "****************",
"AppKey": "****************"
}
}
}
}

appsettings.json config File​

While most settings are now stored in the DB, there are a few settings you can control per server via the appsettings.json file:

{
"uSync": {
"Publisher": {
"Settings": {
"IncomingEnabled": true,
"OutgoingEnabled": true,
"AppId": "****************",
"AppKey": "****************",
"Publisher": "Realtime",
"CleanReports": true,
"PageSize": 50,
"AdditionalFolders": "",
"SystemFolders" : "",
"SystemExclusions" : "",
"FileReplacements" : "",
"IncludeHost" : true,
"ForstHostOption" : false,
"UserAgentString" : "",
"RequestHeaders" : "",
}
}
}
}
PropertyValueNote
incomingEnabledtrue/falseTurns this server on/off for incoming requests. With this setting off the server cannot be published to or pulled from.
outgoingEnabledtrue/falseEnables/disables this server sending publish requests. With this setting off, you will not see the publish/pull options in Umbraco.
AppIdstringApplication ID used alongside AppKey to sign and check any communication between instances.
AppKeystringKey used to sign communications.
PublisherstringThe type of Publisher to use when pushing and pulling content.
CleanReportstrue/falseTurns on/off the trimming of folders after the report stage (this makes imports quicker as less is rechecked).
PageSize50How many items are in a 'page' of data sent between servers
AdditionalFolders~/Views, ~/wwwroot/css, ~/wwwroot/scriptsList of folders to include.
SystemFoldersWhat folders are considered system folders (e.g bin).
SystemExclusions/bin,/app_pluginsThings to exclude from system.
FileReplacementsThings that might be replaced inside a file.
IncludeHosttrue/falseIf the host name is included as part of the signature when signing requests between sites. Turning this value off may make it possible to replay requests on another server.
ForceHostOptiontrue/falseIf true Usync will require a host name as part of the sync.
UserAgentStringSet the user agent string.
RequestHeadersAdd your own custom header key pairs that will get added to every request.