Installation¶
Customer install instructions live in Guides:
This page is a short host-install reference. Everyday GIS users can skip it.
Host layout¶
Customer-facing commands are geojibe and geojibe-setup. The systemd unit is still enciva. Configuration uses ENCIVA_* names. Data paths such as /etc/enciva and /var/lib/enciva are unchanged.
| Item | Location |
|---|---|
| Service | enciva.service (/usr/bin/geojibe) |
| Raster Preview sidecar | geojibe-qgis.service |
| Configuration | /etc/enciva/enciva.env |
| Application data | /var/lib/enciva |
| Listen address | 127.0.0.1:8080 (Apache terminates TLS) |
Do not enable enciva.service until geojibe-setup has written /etc/enciva/enciva.env.
ENCIVA_HOST_DATA_DIR is not used on a host APT install. The official Docker Compose file sets it automatically. See Docker.
Do not install or upgrade host GDAL/QGIS packages for GeoJibe. Processing uses the pinned GDAL image through Docker.
Package lifecycle¶
Add the official repository at https://apt.geojibe.com, then apt install geojibe. Package install creates the geojibe system user and data directories. It does not write secrets or start GeoJibe. Run sudo geojibe-setup next. Repository commands are in Ubuntu / APT.
sudo apt remove geojibe stops the services and removes package files. It does not delete /etc/enciva/enciva.env or /var/lib/enciva. sudo apt purge geojibe still leaves customer data in place.
Database migrations run when enciva.service starts, not during package install.
Settings¶
See Configuration and Deployment models. Shared / hosted GeoJibe is not installed with the customer APT or Compose paths.
If the user database is empty and you are not using geojibe-setup, set bootstrap variables in /etc/enciva/enciva.env before start. There is no default admin password.
Operations¶
Administration, upgrade, backup, and troubleshooting are in Guides: