Skip to main content

Deployment

Erde runs as an on-premises server on Windows. This section is for the administrator who installs, hosts, upgrades, and maintains it. You run a single Erde-Setup.msi installer, then complete configuration in the in-app first-run setup wizard; from there the server hosts both the API and the Blazor client and serves them from one origin.

A deployment uses one database engine — PostgreSQL with PostGIS or Microsoft SQL Server — and two databases: the platform database (erde_platform) and the application database (erde_app). You choose a hosting shape at install time: a Windows Service or an IIS website. Both run the same server; Kestrel serves the app in each.

Set up Erde end to end​

Setting up a production server runs through these steps in order — each links to its full guide. The sequence spans this section, Getting Started, and Administration.

  1. Check system requirements — the Windows version, the .NET 10 Hosting Bundle, and (for IIS) enabling IIS first.
  2. Provision the database — stand up PostgreSQL with PostGIS or SQL Server, with a login Erde can use, reachable from the host.
  3. Install the server — run the MSI and choose a hosting shape (Windows Service or IIS) and port.
  4. Complete first-run setup — the in-browser wizard: database connection, administrator account, and optional license, SMTP, and ArcGIS key.
  5. Secure it with HTTPS — for IIS, add a TLS binding; for a Windows Service, use a reverse proxy.
  6. Activate the license — if you skipped it in the wizard.
  7. Create user accounts — add users and assign each a single role.
  8. (Optional) Configure single sign-on — Windows or OpenID Connect (OIDC / Entra ID).

With the server running, continue to Create your first project.

In this section​

  • System requirements — the supported Windows versions, the .NET 10 Hosting Bundle, and the database engines you need before you install.
  • Install with the MSI — run Erde-Setup.msi, pick a hosting shape and HTTP port, and reach the first-run setup wizard.
  • Hosting: Windows Service vs IIS — what each shape is best for, how each manages the process, and how HTTPS differs between them.
  • Database setup — choose postgresql or sqlserver, supply the connection, and let the server create extensions and run migrations.
  • Upgrades — re-run the MSI for a major upgrade, what it preserves, and how new migrations apply on startup.
  • Backup and restore — what to back up (both databases, the storage folder, and the encryption keys) and how to restore it.
  • Enable HTTPS on the IIS site — add a TLS certificate binding to the Erde IIS site and point Erde at the secure URL.
  • Reverse proxy and HTTPS — run the Windows Service host behind a reverse proxy, setting the public base URL and trusted proxy IPs so HTTPS and links work.
  • Server maintenance and recovery — reset the administrator password, check the health endpoints, and decommission or move a server.
Where to start

New to Erde? Follow the ordered setup sequence above, top to bottom.