Beide images worden ingesteld via omgevingsvariabelen. De namen van de API gebruiken een dubbele
underscore tussen niveaus, zoals Smtp__Host. Een instelling die je weglaat, behoudt
haar standaardwaarde. De starterkits op Hosten met Docker,
Hosten op Kubernetes en Hosten op AKS stellen al
alles in wat een normale installatie nodig heeft; deze pagina is er om er een te wijzigen, of voor
een eigen opstelling (De images draaien).
API: databases
| Instelling | Wat het doet |
|---|
ConnectionStrings__DefaultConnection | De database waarin de data van de standaardwerkruimte staat, zoals Host=postgres;Database=omnicore-db;Username=archestack;Password=.... Verplicht. |
ConnectionStrings__Core | De metadata van de standaardwerkruimte: entiteiten, pagina's, scripts. Database omnicore-core. Verplicht. |
ConnectionStrings__Identity | Gebruikers, werkruimtes en sleutels, gedeeld door elke werkruimte. Database omnicore-identity. Verplicht. |
ConnectionStrings__Keycloak | Alleen bij het overzetten van gebruikers uit Keycloak. Laat het anders leeg. |
ConnectionStrings__Cluster | Hoe meerdere API-instanties elkaar over wijzigingen inlichten. Standaard de identitydatabase; zet het op PostgreSQL zelf wanneer er een connection pooler zoals PgBouncer tussen zit. |
Database__CreateMissing | true maakt de datadatabase aan wanneer die ontbreekt; de andere twee worden hoe dan ook aangemaakt. Standaard false; de kits zetten true. |
De gebruiker in deze strings heeft het recht nodig om databases aan te maken: elke nieuwe
werkruimte krijgt er twee van zichzelf, genoemd naar de basisnamen hierboven.
API: adressen
| Instelling | Wat het doet |
|---|
ASPNETCORE_URLS | Waar de API luistert in de container: http://+:8080. |
ASPNETCORE_ENVIRONMENT | Altijd Production. Al het andere toont foutdetails aan iedereen. |
Http__PathBase | Het pad waaronder de API bediend wordt, zoals /archestack. Leeg op de root. |
Identity__AppBaseUrl | Het adres van de builder, zoals https://apps.example.com/archestack. Links in uitnodigingen en wachtwoordresets wijzen hierheen. |
ForwardedHeaders__TrustedProxies | De adressen van de proxy's ervoor, waarvan X-Forwarded-For geloofd wordt. De standaard dekt privénetwerken; zonder de juiste lijkt elke bezoeker de proxy en delen ze allemaal één rate limit. |
Tenancy__HostSuffix | Bedient elke werkruimte op een eigen hostnaam, <label>.<suffix>, en laat werkruimtes eigen domeinen toevoegen. Standaard leeg. |
API: aanmelden
| Instelling | Wat het doet |
|---|
Identity__Provider | Builtin: Archestack meldt mensen zelf aan. Standaard. |
Identity__InitialAdminEmail, Identity__InitialAdminPassword | De eerste admin, aangemaakt bij de eerste start wanneer er nog geen gebruiker is. Eén keer gebruikt: wijzig het wachtwoord daarna in Archestack. Laat beide weg om de admin in plaats daarvan in de builder aan te maken. |
Identity__AllowCompanySignup | true laat iedereen een eigen bedrijf aanmaken op /register. Standaard false. De admins van een bedrijf kunnen scripts op de server draaien, dus laat het uit tenzij je een openbare dienst draait. |
Identity__AccessTokenMinutes | Hoe lang een aanmeldtoken meegaat voordat het vernieuwd wordt. Standaard 15. |
Identity__RefreshTokenDays | Hoe lang iemand aangemeld blijft zonder Archestack te gebruiken. Standaard 30. |
Identity__MinimumPasswordLength | Standaard 8. |
Identity__MaxFailedLogins, Identity__LockoutMinutes | Na zoveel foute wachtwoorden wordt een account zo lang vergrendeld. Standaard 10 en 15. |
API: mail
| Instelling | Wat het doet |
|---|
Smtp__Host, Smtp__Port, Smtp__UseSsl | De mailserver voor uitnodigingen en wachtwoordresets. Standaard poort 587 en SSL. Zonder host krijgt de admin die een uitnodiging verstuurt de link om door te geven. |
Smtp__Username, Smtp__Password | De aanmeldgegevens van de mailserver. |
Smtp__From, Smtp__FromName | De afzender die die mails tonen. |
De mail die applicaties versturen, gaat via de mailaccounts die elke werkruimte in haar builder instelt.
API: bestanden en back-ups
| Instelling | Wat het doet |
|---|
Files__Directory | Waar uploads en bestanden van werkruimtes terechtkomen, zoals /files. Zet er een volume: in een container zonder volume gaan bestanden verloren bij de volgende update. |
Files__MaxFileBytes | Het grootste afzonderlijke bestand. Standaard 100 MB. |
Files__MaxWorkspaceBytes | Hoeveel één werkruimte mag bewaren. Standaard 0, geen limiet. |
Backup__Directory | Waar back-ups terechtkomen, zoals /backups. Ook een volume, en kopieer wat daar belandt ook ergens anders naartoe. |
Backup__RetentionDays | Hoe lang back-ups bewaard worden. Standaard 30. |
Backup__CronSchedule | Wanneer de nachtelijke back-up draait, als Quartz-cron. Standaard 0 0 3 * * ?, 03:00. |
API: schaal en limieten
| Instelling | Wat het doet |
|---|
Realtime__EntityChanges | false zorgt ervoor dat schermen niet meer verversen wanneer een record elders wijzigt. Standaard true. Uitgeschakeld bedient één installatie veel meer mensen tegelijk; zie Capaciteit en dimensionering. |
Cluster__Enabled | Laat meerdere API-instanties als één werken. Standaard true; laat het aan. |
RateLimiting__Enabled | Limieten op verzoeken per aanroeper. Standaard true. De limieten gelden per API-instantie. |
RateLimiting__PermitsPerMinute | Verzoeken die één persoon per minuut mag doen. Standaard 2000. |
RateLimiting__AuthPermitsPerMinute | Aanmeldpogingen per minuut vanaf één adres. Standaard 20. |
RateLimiting__PublicPagePermitsPerMinute | Wat een bezoeker zonder account per minuut van openbare pagina's mag vragen. Standaard 240. |
Scripting__TypedData__Enabled | Business entities als getypeerde sets in scripts (Db.Order). Standaard true. |
API: sleutels
| Instelling | Wat het doet |
|---|
DataProtection__CertificatePath, DataProtection__CertificatePassword | Een certificaat dat de sleutels beschermt waarmee opgeslagen wachtwoorden versleuteld zijn. Zonder certificaat staan die sleutels onbeschermd in de identitydatabase, dus een kopie van die database bevat beide helften. |
Push__VapidPublicKey, Push__VapidPrivateKey, Push__Subject | Eén sleutelpaar voor browsermeldingen op elke werkruimte. Weggelaten maakt elke werkruimte haar eigen. Wijzig het nooit meer zodra mensen meldingen hebben toegestaan: hun abonnementen werken dan niet meer. |
API: monitoring
| Instelling | Wat het doet |
|---|
Observability__Enabled | Verstuurt traces, metrics en logs via OpenTelemetry. Standaard false. |
Observability__OtlpEndpoint | Waarnaartoe, zoals http://otel-collector:4317. |
Observability__Instance, Observability__Environment | Geeft deze installatie een naam in de dashboards. |
De web-image
| Instelling | Wat het doet |
|---|
VITE_API_URL | Het adres van de API zoals de browser het bereikt, zoals https://api.example.com. Leeg wanneer de API op hetzelfde adres onder /api staat. |
BASE_PATH | Het pad waaronder de image bediend wordt, zoals /archestack. Leeg op de root. |
VITE_UI_MODE | dashboard toont de builder op / en de gepubliceerde app onder /app. kiosk toont de gepubliceerde app op /, voor een adres dat alleen de app is. |
VITE_DASHBOARD_URL | Met kiosk, het adres van de builder wanneer die op een andere hostnaam staat. |
VITE_APP_URL | Met dashboard, het adres van de gepubliceerde app wanneer die op een andere hostnaam staat. |
API_INTERNAL_URL | Het adres van de API binnen het netwerk, zoals http://api:8080. Linkvoorbeelden in chatapps en de pagina's die zoekmachines lezen, komen daarvandaan. Schrijf in Kubernetes de volledige naam van de service, http://<service>.<namespace>.svc.cluster.local:8080. |
De PostgreSQL-image
| Instelling | Wat het doet |
|---|
POSTGRES_USER, POSTGRES_PASSWORD | De gebruiker waarmee de API verbinding maakt. Het wachtwoord wordt ingesteld wanneer PostgreSQL voor het eerst start op een lege schijf; de variabele later wijzigen, wijzigt het niet in de database. |
POSTGRES_DB | postgres. De API maakt zijn eigen databases aan. |
PGDATA | Alleen op een verse schijf waarvan de root lost+found bevat, zoals in Kubernetes: een map onder het koppelpunt, zoals /var/lib/postgresql/data/pgdata. |
Geef de container 1 GB gedeeld geheugen, zoals De images draaien uitlegt.