Kom igång¶

Prova på 5 minuter (Docker)¶

Snabbaste vägen till en klickbar miljö — ingen SDK, ingen databas att installera. Startar Hodor + SQL Server med en färdig demokälla (HodorDemo), ett måldatalager (HodorDW) och två exempel-pipelines redo att köra:

docker compose --env-file demo/.env -f docker-compose.yml -f docker-compose.demo.yml up --build
# → http://localhost:5200  (logga in: admin / Admin1234!)

--env-file demo/.env ger demo-hemligheterna. Bas-composen kräver SA_PASSWORD, JWT_KEY och HODOR_ADMIN_PASSWORD utan standardvärden. Endast för demo.

Öppna Arbetsflöden, kör Demo_Load_DimCustomer, och följ stegen i realtid.

Bygg från källkod¶

Förkrav¶

.NET 10 SDK
Node.js 22+ och npm
SQL Server eller PostgreSQL (metadatadatabas, källa och/eller mål)
Python 3 (valfritt, för Python-skript i pipelines)

Bygg och kör lokalt¶

# 1. Bygg Angular-appen
cd hodor-web
npm install
npm run build        # output: hodor-web/dist/hodor-web/browser/

# 2. Starta API:et (serverar också Angular-appen)
cd ../Hodor.Api
dotnet run
# → http://localhost:5200

För frontend-utveckling med hot reload:

cd hodor-web
npm start            # ng serve med proxy mot localhost:5200

Obligatoriska miljövariabler¶

Variabel	Beskrivning
`Jwt__Key`	Hemlig nyckel för JWT-signering. Minst 32 tecken.
`Hodor__DefaultAdmin__Password`	Lösenord för det inbyggda admin-kontot som skapas vid första starten.
`Database__Provider`	`Postgres` eller `SqlServer`.
`Database__ConnectionString`	Connection string till vald databas.

Miljövariablerna kan alternativt anges i Hodor.Api/appsettings.Development.json under lokal utveckling — filen ingår inte i versionshanteringen.

Konfiguration¶

// Hodor.Api/appsettings.json
{
  "Hodor": {
    "PipelinesFolder": "/pipelines"
  },
  "Database": {
    "Provider": "SqlServer",
    "ConnectionString": "Server=...;Database=HodorMeta;..."
  }
}

Miljövariabler: HODOR__PIPELINESFOLDER, DATABASE__PROVIDER, DATABASE__CONNECTIONSTRING.

Windows-autentisering

Använd Windows-autentisering (Trusted_Connection=True) när SQL Server körs on-prem — då innehåller .hodor-filerna inga hemligheter och kan checkas in i git utan risk.