Ubuntu / APT¶

Install GeoJibe on a host with the official Debian package, then run geojibe-setup.

This is the supported host install for Ubuntu 24.04 LTS amd64. Dedicated and On-Site customers use the same package and the same setup utility.

Before you start¶

Ubuntu 24.04 LTS amd64
A GeoJibe license key (On-Site) or a managed provisioning grant (Dedicated operators)
A public hostname if you will use Let's Encrypt

geojibe-setup installs Docker Engine from Docker's official APT repository when it is missing. An existing working Docker Engine (Docker CE or docker.io) is left in place. Docker is the spatial processing runtime; do not install or upgrade host GDAL or QGIS packages for GeoJibe.

The package depends on Apache. Setup configures Apache as the reverse proxy and TLS terminator.

Add the GeoJibe APT repository¶

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://apt.geojibe.com/geojibe-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/geojibe-archive-keyring.gpg >/dev/null

echo "deb [signed-by=/etc/apt/keyrings/geojibe-archive-keyring.gpg] https://apt.geojibe.com stable main" \
  | sudo tee /etc/apt/sources.list.d/geojibe.list

sudo apt update

apt-cache policy geojibe

apt-cache policy geojibe should show the package from https://apt.geojibe.com.

Install¶

sudo apt install geojibe
sudo geojibe-setup

You can run geojibe-setup from any directory.

Note

Package install creates the geojibe system user and the data directories. It does not write secrets, enable Apache sites, pull processing images, or start GeoJibe. Do not run systemctl enable --now enciva until setup has finished.

What `geojibe-setup` asks¶

Host setup does not ask you to choose Dedicated vs On-Site. It configures a self-hosted installation and uses the normal GeoJibe activation process.

Interactive setup asks for:

GeoJibe hostname — used as https://<hostname>
Administrator username — a local username, not an email address
Administrator password — at least 10 characters; typed twice and not echoed
Enable Raster Preview? — default Yes (starts QGIS Server for visual raster preview)
TLS certificate source
- 1 = Let's Encrypt / Certbot (default)
- 2 = Existing certificate files (fullchain PEM and private key)
Configure SMTP now? — default No
Configure Google Drive OAuth now? — default No
GeoJibe license key — not echoed

If Docker Engine is missing, setup also prints that Docker Engine is required and asks Install Docker Engine now? (default Yes). Automatic Engine installation is supported on Ubuntu 24.04 LTS amd64 only.

When SMTP is enabled, setup asks for host, port (default 587), username, password, TLS mode (starttls, tls, or none), From address, and From name (default GeoJibe).

When Google Drive is enabled, setup shows the exact OAuth callback URI and asks for the Google OAuth Client ID and Client Secret.

Note

Dedicated operators who provision a managed license run sudo geojibe-setup --managed-license lic_… and enter a one-time provisioning token when prompted. Do not put that token on the command line.

What setup configures¶

geojibe-setup writes /etc/enciva/enciva.env, activates the license into the data directory, installs Docker Engine when it is missing, pulls the pinned GDAL image, optionally starts QGIS Server, enables Apache, and starts GeoJibe.

GeoJibe listens on 127.0.0.1:8080
Apache terminates HTTPS on ports 80/443 and reverse-proxies the hostname to GeoJibe
QGIS Server, when enabled, is bound to 127.0.0.1:8090 and is not proxied
The first administrator is created on first start; change that password after you sign in

Rerunning sudo geojibe-setup detects an existing installation. It does not replace the administrator or erase application data. A valid existing secret key is preserved.

After setup¶

Sign in at https://<hostname> and change the bootstrap password.

If Let's Encrypt could not finish, setup leaves the HTTP reverse-proxy site enabled and prints the remaining Certbot commands. Typical remaining action:

sudo certbot --apache -d <hostname>

After certificates exist:

sudo a2ensite geojibe-le-ssl
sudo apache2ctl configtest
sudo systemctl reload apache2

If QGIS is down after setup, Inspect, Convert, and Jobs continue. Only visual Raster Preview is unavailable.

Administration¶

The systemd unit is still named enciva:

sudo systemctl status enciva
sudo systemctl restart enciva
sudo journalctl -u enciva -n 50 --no-pager

Raster Preview uses a separate unit:

sudo systemctl status geojibe-qgis
sudo journalctl -u geojibe-qgis -n 50 --no-pager

Apache:

sudo systemctl status apache2
sudo apache2ctl configtest
sudo systemctl reload apache2

Remove the package¶

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. Delete those paths only if you intend to destroy the installation.