Mapic is an Open Source Web Map Engine.

For a technical overview, see the wiki.

Install

Install the Mapic CLI:

On OSX or Ubuntu:

# install mapic cli
git clone https://github.com/mapic/mapic.git
cd mapic/cli 
sudo bash mapic-cli.sh

Install Mapic

# enter folder
cd mapic

# configure
mapic configure

# start mapic
mapic start

Usage

Mapic CLI

Usage: mapic COMMAND

A CLI for Mapic

Management commands:
  start               Start Mapic stack
  stop                Stop Mapic stack
  restart             Stop, flush and start Mapic stack
  status              Display status on running Mapic stack
  logs [container]    Show logs of running Mapic server
  scale               Scale containers across nodes

Commands:
  configure           Automatically configure Mapic
  install             Install Mapic
  config              View and edit Mapic config
  domain              Set Mapic domain
  volume              See Mapic volumes
  dns                 Create or check DNS entries for Mapic
  ssl                 Create or scan SSL certificates for Mapic
  enter               Enter running container
  run                 Run command inside a container
  grep                Find string in files in subdirectories of current path
  ps                  Show running containers
  debug               Toggle debug mode
  version             Display Mapic version
  info                Display Mapic info
  test                Run Mapic tests
  bench               Run Mapic benchmark tests
  update              Update Mapic repositories

API commands:
  api login           Authenticate with (any) Mapic API
  api user            Handle Mapic users
  api upload          Upload data
  api project         Handle projects

Manage Mapic server

Commands for managing the Mapic server.

# start server
mapic start

# see status
mapic status

# show logs
mapic logs

# tail logs of specific container
mapic logs postgis

# stop mapic server
mapic stop

Troubleshoot most common issues

Ensure services are up, and look through logs.

# ensure all services are up
mapic status

# show logs, look for errors
mapic logs engine [mile | postgis | redis | mongo | nginx]

Restart Mapic

# stop services
mapic stop

# wait until all services are stopped (1 min)
mapic status

# restart services
mapic start

Update SSL certificate

# stop services
mapic stop

# wait until all services are stopped (1 min)
mapic status

# create ssl certificates
mapic ssl create

# restart services
mapic start

Interact with the Mapic API

Commands for interacting with any running Mapic server's API.

# login
mapic api login

# create user
mapic api user create

# promote to superuser
mapic api user super 

# see help for more commands and options
mapic api help

Depends

• Git
• Docker

The Mapic CLI will attempt to install these automatically on Ubuntu and OSX.

Mapic is built with Docker. Docker images for Mapic are available on the Docker Hub.

Licence

Mapic is built entirely open source. We believe in a collaborative environment for creating strong solutions for an industry that is constantly moving. The Mapic platform is open for anyone to use and contribute to, which makes it an ideal platform for government organisations and NGO's, as well as for-profit businesses. Please see https://mapic.io for hosted solutions.

Mapic is licensed under the AGPL licence.

Project contributors

• Frano Cetinic
• Jørgen Evil Ekvoll
• Magdalini Fotiadou
• Terrence Lam
• Sandro Santilli
• Knut Ole Sjøli
• Shahjada Talukdar
• Igor Ziegler