Getting started4 min read
Installing GeoDoctor
Run the installer, verify the services, serve your team, update.
One installer bundles the runtime, the database and the application. It registers two Windows services, GeoDoctorPostgres and GeoDoctorBackend, and initialises everything in about three minutes.
- Download the installer from Portal → Downloads. The page prints its SHA-256.
- Check the file against it: Get-FileHash GeoDoctor-Setup-<version>.exe -Algorithm SHA256.
- Run it as Administrator. Keep the ports (7007 and 5433) or choose others.
- When it finishes, the browser opens http://localhost:7007/ on the Activation screen.
- Activate your licence (see “Activating a licence”), then create the first administrator account.
powershell
Get-Service GeoDoctor*
# GeoDoctorPostgres and GeoDoctorBackend should both report Running.
Invoke-RestMethod http://localhost:7007/api/v1/health
# status: healthyServing your team#
GeoDoctor listens on 127.0.0.1 only until you give it a certificate, and it never serves plain HTTP on a network address. Get a certificate from your organisation’s CA for the name users will type, put the PEM files in C:\ProgramData\GeoDoctor\config\certs\, and create geodoctor.local.env beside geodoctor.env:
ini
GEODOCTOR_HOST=0.0.0.0
GEODOCTOR_TLS_CERTFILE=C:\ProgramData\GeoDoctor\config\certs\server.crt
GEODOCTOR_TLS_KEYFILE=C:\ProgramData\GeoDoctor\config\certs\server.key
GD_SECURITY_ALLOWED_HOSTS=geodoctor.example.org,localhost,127.0.0.1
GD_PUBLIC_URL=https://geodoctor.example.org:7007Important
Every host name users reach GeoDoctor by must be in GD_SECURITY_ALLOWED_HOSTS: a request carrying another one is refused by design. Open port 7007 to your users’ network only, and never open 5433. Upgrades never rewrite geodoctor.local.env.
Updating#
- Settings → Updates shows a new version when one is published. Nothing is downloaded or installed until an administrator chooses to.
- The download there is signed for your installation; or take the installer from Portal → Downloads. Check its SHA-256 and run it over the installed version: your data is kept.
- With no internet on the server, copy the installer across and run it the same way.
- Installations of 3.9.5 or older do not offer 3.9.6 or later by themselves: install the new version by hand once, and we re-issue your licence file for it.
Stuck on something not covered here? Email [email protected] — a person replies within one business day.