Install

Install GratisGIS

GratisGIS runs as one Docker Compose stack on one Linux host. This page is a short overview. The full guide, with backups, health checks and recovery, is docs/deployment.md on GitHub.

What you need

A Linux server you can SSH into. The public demo runs on 4 CPU cores and 8 GB RAM, which is a comfortable baseline for a small organization. Plan for 20 GB or more of free disk.
Docker Engine with the Compose v2 plugin, plus git, curl, openssl and python3.
Three DNS records pointing at the server: the portal, an auth host and a storage host. For example gis.example.org, auth.gis.example.org and storage.gis.example.org. Certificates come from Let's Encrypt.

Install with one command

curl -fsSL https://raw.githubusercontent.com/\
  palavido-dev/gratis-gis/main/infra/install.sh | bash

The installer clones the repository to /opt/gratis-gis, checks out the newest release, asks for your domain and email, generates the secrets, deploys, and prints where to sign in. It checks for Docker but does not install it for you.

Prefer to see each step? The same flow by hand:

git clone https://github.com/palavido-dev/gratis-gis /opt/gratis-gis
cd /opt/gratis-gis
./infra/setup.sh
./infra/deploy.sh
./infra/doctor.sh

On a home or office NAS

On TrueNAS SCALE 25.10 or newer, or Dockge, you paste one Compose file. No domain name is needed. Steps are in docs/truenas.md.

Upgrades

Run ./infra/deploy.sh again. It moves to the newest release, applies database migrations and swaps containers. Back up first. The full procedure, including rollback, is in docs/UPGRADING.md.

Working on the code

To run GratisGIS on a workstation for development, follow docs/SETUP.md.

Try the live demo first Read the full guide