Getting Started

Getting Started

Prerequisites

• Docker and Docker Compose
• Git
• A Mapbox access token (free tier is sufficient)

Installation

1. Clone the Repository

git clone https://github.com/raft-tech/GeoSet.git
cd GeoSet

2. Configure the Environment

cp docker/.env.example docker/.env

Open docker/.env and set your Mapbox token:

MAPBOX_API_KEY=your_mapbox_token_here

3. Start the Application

docker compose up -d

On first run, the superset-init container automatically:

• Runs database migrations
• Creates an admin user (admin / admin)
• Sets up default roles and permissions

Once all containers are healthy, open http://localhost in your browser and log in with admin / admin.

Services

Service	Port	Description
nginx	80	Reverse proxy (main entry point)
superset	8088	Flask backend API
superset-node	9000	Webpack frontend dev server
superset-websocket	8080	WebSocket server
db	5432	PostgreSQL (Superset metadata)
redis	6379	Cache and Celery broker

Common Commands

# Start all services (Base Superset)
docker compose up -d

# Start all services (GeoSet Stack)
docker compose -f docker-compose-geoset.yml up

# Rebuild after Dockerfile changes (GeoSet stack)
docker compose -f docker-compose-geoset.yml up --build

# View logs for a specific service
docker compose logs -f superset

# Restart the frontend dev server
docker compose restart superset-node

# Stop all services
docker compose down

# Stop and remove all data (full reset)
docker compose down -v

# Rebuild after Dockerfile changes
docker compose up -d --build

Next Steps

• Load the Sample Data and Demo Dashboards to see GeoSet in action
• Create your first map chart: GeoSet Map Layer Chart
• Combine multiple layers: GeoSet Multi Map Chart