https://github.com/3liz/lizmap-docker-compose
Run Lizmap stack with docker-compose
https://github.com/3liz/lizmap-docker-compose
lizmap qgis-processing qgis-server qgis-wps wps
Last synced: 6 months ago
JSON representation
Run Lizmap stack with docker-compose
- Host: GitHub
- URL: https://github.com/3liz/lizmap-docker-compose
- Owner: 3liz
- Created: 2018-09-12T11:39:20.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-12T07:59:00.000Z (10 months ago)
- Last Synced: 2025-03-31T16:14:11.931Z (6 months ago)
- Topics: lizmap, qgis-processing, qgis-server, qgis-wps, wps
- Language: Shell
- Homepage:
- Size: 284 KB
- Stars: 35
- Watchers: 11
- Forks: 42
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Run Lizmap stack with docker-compose
Run a complete Lizmap stack with test data.
- Lizmap Web Client
- QGIS Server
- Redis
**Note**: this is a sample configuration for testing Lizmap web client with QGIS and WPS features.
❗**If you want to use it on a production server, you will need to make adjustments to meet your
production requirements.**
## Requirements
- Docker engine
- docker-compose v2
## Quick start
Execute the commands below for your system and open your browser at http://localhost:8090.
### Linux
In a shell, configure the environment:
```bash
./configure.sh configure
```
Or if you want to test specific version (here last 3.X.Y version):
```bash
LIZMAP_VERSION_TAG=3.8 ./configure.sh configure
```
Run lizmap:
```bash
docker compose pull
docker compose up
```
To run lizmap visible to another system, prefix the docker command with a variable. NB! This will be plain HTTP with no encryption and not suitable for production.
```bash
LIZMAP_PORT=EXTERNAL_IP_HERE:80 docker compose up
```
### Windows
In order to user Docker on Windows you may install [Docker desktop for Windows](https://docs.docker.com/desktop/windows/install/)
If you have some distribution installed (Ubuntu, ...) in WSL, you can simply run the linux command as above, once in it.
Or in PowerShell, run the following command to set up some files
```bash
configure.bat
```
You can then launch the docker using
```bash
docker compose --env-file .env.windows up
```
Or if you want to test specific version, you can edit `.env.windows` and change (here last 3.X.Y version):
```bash
LIZMAP_VERSION_TAG=3.8
```
## Running the first time
The previous commands create a docker-compose environment and run the stack
The Lizmap service will start two toys projects that you will have to configure in the Lizmap
interface.
See the [Lizmap documentation](https://docs.lizmap.com) for how to configure Lizmap at first run.
Default login is `admin`, password `admin`. It will be asked to change it at first login.
## Add your own project
You need to :
* create a directory in `lizmap/instances`
* visit http://localhost:8090/admin.php/admin/maps/
* in the Lizmap admin panel, add the directory you created
* add one or more QGIS projects with the Lizmap CFG file in the directory
## Reset the configuration
In command line
```bash
./configure.sh clean
```
This will remove all previous configuration. You will have to reenter the configuration in Lizmap
as for the first run.
## References
For more information, refer to the [docker-compose documentation](https://docs.docker.com/compose/)
See also:
- https://github.com/3liz/lizmap-web-client
- https://github.com/3liz/py-qgis-server
Docker on Windows:
- https://docs.docker.com/desktop/windows/
- https://docs.microsoft.com/fr-fr/windows/dev-environment/docker/overview