Skip to main content
Version: v15.x - Umbraco 15

Setting Up Umbraco for Commandline

In order to use uSync.CommandLine you have to make an API user. You can do this in the users section of Umbraco.

The create button in Users, showing the User and API User options in the dropdown.

Create the API user and add them to the relevant group!

Create API user tab in the users tab.

Add a Client Secret and Key​

Once you have created an API user, you will need to give them a Client ID and Secret.

The client credentials tab.

You will need both the Client ID and a Secret to connect via the CommandLine.

The create client credential window.

Add an appsetting.json File​

You can add an appsettings.json file to the root of the folder where you are running uSync.CommandLine:

{
  "uSync": {
    "Command": {
      "Secret": "[CLIENT_SECRET]",
      "ClientId": "[CLIENT_ID]"
    }
  }
}

Or Use the -k -i Settings​

Alternatively, you can pass these on the CommandLine. eg.

usynccli usync-ping -s https://localhost:44359 -s [client_secret] -k [client_id]

Once this is set up, you can use all the Commands!