Skip to content

Local Development Installation

Summary

Use this guide when you want to run SkyCMS locally for feature development or debugging.

Prerequisites

  • .NET SDK compatible with the solution.
  • A local or remote database connection string.
  • A storage connection string (or test storage account/bucket).

Outcome

After completing this guide, you should be able to run SkyCMS locally, complete setup, and verify a first publish flow.

Configure environment variables

Set at least the required values shown below:

$env:CosmosAllowSetup = "true"
$env:ConnectionStrings__ApplicationDbContextConnection = "Data Source=D:\\data\\cosmoscms.db"
$env:ConnectionStrings__StorageConnectionString = "Bucket=my-bucket;Region=us-east-1;KeyId=...;Key=...;"
$env:AzureBlobStorageEndPoint = "/"
$env:CosmosPublisherUrl = "http://localhost:5000"

Run the app

From the repository root:

dotnet run --project Sky.Editor.csproj

Then open http://localhost:5000/___setup, or the local URL you configured.

Verify setup

  1. Complete the setup wizard at http://localhost:5000/___setup and confirm all steps pass.
  2. Sign in with the administrator account and verify the editor loads.
  3. Upload a test file and confirm it is accessible at the expected URL.
  4. Create and publish a test page and verify it renders correctly.