Skip to main content
Version: v8.x - Umbraco 8

3. Add Server

Before you can start to send or pull content between Umbraco installations you will need to add a server setup on the server you want to push from or pull to.

Add Server Menu

Before one site can push/pull settings to another, you will need to set up a server configuration on that server. To do this, go to the uSync.Publisher pages within the settings section of Umbraco and select "Add Server".

Select add server from the menu

Select a Template

You can then choose a template to use when adding a server, or choose blank. Which template you choose will depend on how you are setting up your servers and how much control you want to give your users.

Select a template

Pick Settings

There are several settings you can enable for a server. The exact details of each one as described in the documentation.

Option Flags

For each option there are two toggles. These determine the default state of an option, as well as whether the user can turn the setting on or off at the point of publishing.

content-buttons

Which options you let your users choose is up to you - the simpler the better!

Note: Include Ancestors and Include Linked can result in a large amount of content or media being synced. They are best left to their default values unless you know you will need to include everything each time you publish.

Sync API Keys

Before you can send/receive any settings the server will need to be sharing keys. You should check you have setup shared keys between the servers.

Check Access

Once you have set up the server, you can check whether access is correctly configured by clicking the 'Check Access' button

check access

The Check Access button will give you the following responses:

ResponsePossible Cause
AvailableEverything is working.
UnauthorizedThe AppID/AppKey used is incorrect.
UnreachableThe server cannot be contacted (could be off).
DisabledThe target server is not enabled (check its settings).
ServerErrorThere is something wrong with the target server.