Installation#
Installation is done via the install scripts located in the /installer directory.
System Requirements#
2 GB RAM
5 GB Disk
Tested on Ubuntu 24
Note
Seeding and tile generation can be CPU intensive for larger data sets. Plan accordingly.
ECW Support#
For ECW Support, use the Quail ECW Support installer prior to installation
Installer (Recommended)#
Clone the repository:
git clone https://github.com/AcuGIS/quail.git
Change to the /quail directory and run the installers in sequence below:
If you already have PostgreSQL with PostGIS enabled, skip the postgres.sh script.
cd quail
./installer/postgres.sh
./installer/app-install.sh [--no-mapproxy]
Optionally, run below to provision SSL using letsencrypt:
apt-get -y install python3-certbot-apache
certbot --apache --agree-tos --email hostmaster@yourdomain.com --no-eff-email -d yourdomain.com
Login at https://yourdomain.com/login.php
Default credentials
Email: admin@admin.com
Password: quail

Note: If you see below when navigating to your domain, remove the default index.html page from /var/www/html

Docker Install#
Warning
Docker is not recommended for Production hosting.
To install using Docker:
git clone https://github.com/AcuGIS/quail.git
cd quail
installer/docker-install.sh
docker-compose pull
Next, go to docker/public.env and set the SERVER_NAME and IP to your machines hostname and IP.
docker-compose up
If you want to build from source, run next command.
To clean persistent data, you can remove volumes with this command:
docker volume rm quail_{cache_qgis,data_layers,data_qgis,data_mapproxy,data_stores,html_layers,html_stores,pg_data,www_cache}
Navigate to http://yourdomain.com:8000
Default credentials
Email: admin@admin.com
Password: quail