Installation

UmbSocial supports Umbraco 17.6 or later, on .NET 10.

Install the packages

UmbSocial is installed using the NuGet package manager:

dotnet add package UmbSocial.Core

UmbSocial publishes through Umbraco Automate 17.4 or later. Install and set up Automate as its documentation describes.

Then install the Automate provider package for each network you want to post to. Social only offers a network when its provider package is installed:

Network	Package
Bluesky	`UmbHost.Automate.Bluesky`
Mastodon	`UmbHost.Automate.Mastodon`
LinkedIn (company page)	`UmbHost.Automate.LinkedIn`
X	`UmbHost.Automate.X`
Facebook and Instagram	`UmbHost.Automate.Meta`

dotnet add package UmbHost.Automate.LinkedIn

The LinkedIn and X packages sign in with OAuth and bring in Umbraco.Automate.OpenIddict. Each network’s setup is on its own page under Connecting networks.

Alternatively, you can install using the NuGet package manager GUI within Visual Studio.

Set the application URL

When a post has an image, the network downloads it from your site. Social sends each post from a background job, where there is no request to take the site’s address from, so the address comes from the UmbracoApplicationUrl setting:

"Umbraco": {
  "CMS": {
    "WebRouting": {
      "UmbracoApplicationUrl": "https://www.mysite.com/"
    }
  }
}

Without it, Social uses the address of the first request the site served since it started. A post with an image that is due before any request has been served fails with media.unresolvable, and is safe to retry.
The address must be https. A post whose image or link isn’t an absolute https URL fails with dispatch.invalid_url, and nothing is sent.
Media on a CDN or blob storage that already has an absolute URL is used as it is.

To build image URLs another way, see Replacing services.

The database

UmbSocial keeps its data in the Umbraco database, in its own tables (umbSocialChannel, umbSocialPost, umbSocialPostTarget, umbSocialPostingSlot, umbSocialSettings) with its own migrations history table (__umbSocialMigrations).

SQL Server and SQLite are supported. Any other database provider stops the site at startup with a message saying so.
The tables are created and updated when the site starts, once Umbraco’s own database is up to date. You don’t need to run anything.
On install, an Umbraco package migration gives the Administrators group the Social section and every Social permission. No other group is changed. See Permissions.

Upgrades

UmbSocial updates its tables when the site starts, so upgrades follow the same process as installation: update the packages and start the site.

Installing a licence

The free edition needs no licence key. If you have a paid edition, see Editions and licensing.