Install Erde
Erde is an on-premises application that runs on Windows. You install it from a single MSI package, choose a hosting shape, and the installer hands off to an in-app setup wizard. This page gives the high-level path; the Deployment guide has the full procedure, system requirements, and database setup.
- Role required: Local administrator on the target Windows server.
- Prerequisites: A supported Windows server with the .NET 10 Hosting Bundle (x64) installed, and a reachable PostgreSQL or SQL Server database. See Deployment for the full requirements list.
Choose a hosting shape
You pick how Erde is hosted at install time. In both shapes the Kestrel web server serves the API and the Blazor web client; the difference is what sits in front of it: a Windows Service or IIS (Internet Information Services).
| Windows Service | IIS | |
|---|---|---|
| Best for | Small firm, 1–5 users, single office | Multi-office, field crews, 5+ users |
| Process | Erde.Server.exe as a Windows service | IIS app pool (in-process) |
| HTTPS | Add a reverse proxy | IIS certificate UI |
| Prerequisite | .NET runtime only | IIS enabled before the Hosting Bundle |
Steps
- Sign in to the target Windows server as a local administrator.
- Install the .NET 10 Hosting Bundle (x64) if it is not already present. For IIS hosting, enable IIS before installing the Hosting Bundle.
- Run
Erde-Setup.msi. - On the Deployment Configuration screen, select IIS Website or Windows Service, and set the HTTP Port (default
5000). - Complete the installer. It deploys files to
C:\Program Files\Erde\, configures the chosen host, adds firewall rules, and opens your browser tohttp://localhost:<port>/setup(the port you chose in step 4).
Result
The Erde server is installed and running, but not yet configured. Because no appsettings.Production.json exists, the server starts in setup mode and serves the first-run wizard at /setup. The wizard collects the database connection, the initial administrator account, and other settings.
Troubleshooting
| Symptom | Cause | Resolution |
|---|---|---|
| Installer reports a missing runtime | The .NET 10 Hosting Bundle is not installed | Install the x64 Hosting Bundle, then re-run the MSI |
| IIS mode fails to serve requests | IIS was enabled after the Hosting Bundle | Run a repair install of the Hosting Bundle to register the ASP.NET Core Module |
Browser does not reach /setup | The port is in use or blocked | Confirm the chosen port is free and allowed through the firewall; see Deployment |