Skip to main content
Version: 1.2.0

Quickstart Widows

For an quick and tested local installation:
(Requirement 16+GB RAM)

winget install -e --id Docker.DockerDesktop
winget install -e --id Microsoft.WSL
winget install -e --id k3d.k3d
winget install -e --id Kubernetes.kubectl
winget install -e --id Helm.Helm
winget install -e --id Git.Git
git clone https://gitlab.com/civitas-connect/civitas-core/civitas-core.git

Setup Developer Enviroment

Start Docker (might require restart).
Open new cloned folder and activate .devcontainer in your IDE (e.g. VS-Code).

Setup local k8s Cluster

After successfully activating the devcontainer. Run inside .decontainer terminal (VS-code termianl):

./local_deployment/startup.sh -k

Open file at C:\Windows\System32\drivers\etc\hosts and add domain entries (and save as Admin):

127.0.0.1 civitas.test
127.0.0.1 alertmanager.civitas.test
127.0.0.1 api-dashboard.civitas.test
127.0.0.1 api.civitas.test
127.0.0.1 api-admin.civitas.test
127.0.0.1 apim.civitas.test
127.0.0.1 geoportal.civitas.test
127.0.0.1 geoserver.civitas.test
127.0.0.1 grafana.civitas.test
127.0.0.1 idm.civitas.test
127.0.0.1 mimir.civitas.test
127.0.0.1 minio-tenant-console.civitas.test
127.0.0.1 minio-tenant.civitas.test
127.0.0.1 monitoring.civitas.test
127.0.0.1 mqtt.civitas.test
127.0.0.1 oauth.civitas.test
127.0.0.1 oauth.geoportal.civitas.test
127.0.0.1 pgadmin.civitas.test
127.0.0.1 superset.civitas.test

Install Civitas Core in k8s

Run the playbook using an inventory. Default values are in core_platform/default_inventory.yml.
The default is also used as a fallback if a variable is not specified.

inventory_loc_k3d.yml is a minimal inventory for Civitas-Core using a local k3d cluster.
For customization, core_platform/default_inventory.yml can be used as a baseline.

ansible-playbook -l localhost -i inventory_loc_k3d.yml core_platform/playbook.yml