NextGIS Web Community Edition
April 20, 2026 · View on GitHub
Official Docker-based setup for running NextGIS Web Community Edition.
This repository is intended for users and developers who want to launch a self-hosted NextGIS Web instance with Docker.
Table of contents
- What is NextGIS Web
- Quick start with plain Docker
- Docker Compose
- Repository overview
- Building images from sources
- Commercial support
- Community and ecosystem
What is NextGIS Web
NextGIS Web is an open-source Web GIS server for geospatial data management, web map publishing, and QGIS-centered collaborative workflows.
It combines a powerful spatial backend, a web-based interface for administration and map publishing, and a full REST API. Suitable for projects ranging from small teams to enterprise-grade GIS infrastructures.
For the core application detailed description and source code, see the main repository: nextgis/nextgisweb.
Quick start with plain Docker
Using a plain Docker container is the easiest way to get NextGIS Web CE up and running. It is suitable for testing and experimentation, but Docker Compose (see below) is recommended for continuous use. Assuming Docker is installed and running on your machine, run the following command to start NextGIS Web CE in a named container with a persistent volume (26.04.0 is the current version):
docker run --name ngw_ce -dp 8080:8080 -v ngw_ce:/opt/crater/data nextgis/nextgisweb-ce:26.04.0 server
Wait a few moments, then you can access your Web GIS:
- URL:
http://localhost:8080 - Login:
administrator - Password:
admin
If you encounter any issues, check the logs with:
docker logs ngw_ce
To remove the container and all data, run the following commands:
Caution
This will remove all NextGIS Web data, so make sure you no longer need it or have a backup before proceeding.
docker rm --force ngw_ce
docker volume rm ngw_ce
Docker Compose
Docker Compose is recommended for continuous use of NextGIS Web CE. Itsimplifies container and volume management and makes updates and maintenance easier.
Installation
You must have Docker Compose 2.x installed on your machine. For simplicity, this guide assumes you are running everything from a root shell (sudo -i for example). So, first create a directory for the stack, for example /srv/ngw_ce:
mkdir /srv/ngw_ce
cd /srv/ngw_ce
Create the /srv/ngw_ce/.env file with the following contents, where 26.04.0 is the current version:
IMAGE_VERSION=26.04.0
Then create /srv/ngw_ce/docker-compose.yaml:
services:
app:
image: nextgis/nextgisweb-ce:$IMAGE_VERSION
command: server
environment:
NEXTGISWEB__CORE__LOCALE__DEFAULT: "en"
ports:
- 8080:8080
volumes:
- data:/opt/crater/data
- backup:/opt/crater/backup
restart: unless-stopped
volumes:
data:
backup:
Start the stack with the following command:
docker compose up -d
Wait until the stack starts, then open http://localhost:8080 in your browser and log in with administrator / admin.
If you encounter any issues, check the logs with:
docker compose logs
Configuration
Environment variables are the recommended way to configure NextGIS Web. You can add them to the environment section of the app service in the docker-compose.yaml file. The list of available environment variables can be obtained by running the following command:
docker compose run --rm app nextgisweb-config --env-vars
After making changes to the docker-compose.yaml file, apply them with the following command:
docker compose up -d
NextGIS Web CLI
To execute NextGIS Web CLI commands inside the container, use docker exec app nextgisweb followed by the command you want to run. For example, to run maintenance tasks, you can use:
docker compose exec app nextgisweb maintenance
Reverse proxy configuration
It is recommended to run NextGIS Web CE behind a reverse proxy that handles TLS termination. The most common choice is Nginx, the configuration template for which is provided below.
Nginx configuration template
# $http_upgrade variable must be set in the root block of the http,
# see https://nginx.org/en/docs/http/websocket.html
map $http_upgrade $proxy_connection {
default upgrade;
'' close;
}
server {
server_name ngw.example.com;
# Server directives: listen, ssl_* etc
location / {
client_max_body_size 0;
proxy_read_timeout 3600s;
proxy_http_version 1.1;
proxy_pass http://localhost:8080;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $proxy_connection;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $remote_addr;
}
}
Uninstalling
Caution
The following commands will remove all NextGIS Web data. Make sure you no longer need it or have a backup before running them.
docker compose down --volumes --remove-orphans
Repository overview
Here is a brief overview of the repository structure:
package- submodules with NextGIS Web core package and extensionsbuild- Docker build context skeletoncrater- submodule with NextGIS Dockerfile generation toolkit
Note
The crater submodule points to a private repository, as it is tightly coupled with NextGIS internal infrastructure. You don't need access to it to build or run NextGIS Web CE. Everything you need to build the image is vendored in the build directory.
Building images from sources
To build the NextGIS Web CE image from sources you need to have Just installed on your Linux machine. Then run the following commands:
git clone git@github.com:nextgis/nextgisweb_ce.git
cd nextgisweb_ce
just build
After that, you can run the container as described in the "Quick start with plain Docker" section, using nextgisweb-ce as the image name.
Commercial support
Professional support, cloud and enterprise deployments, and consulting services are available from the NextGIS team.
🏢 Professional on-premise deployment
✉️ Contact us
Community and ecosystem
🐞 GitHub issues and discussions
🧩 NextGIS Web - main repository