Skip to main content
Version: Next

Quickstart Mac

For an quick and tested local installation:

brew install --cask docker
brew install k3d kubectl helm openssl
git clone https://gitlab.com/civitas-connect/civitas-core/civitas-core.git
cd civitas-core

Setup Developer Enviroment​

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
ansible-galaxy collection install -r ansible-collections.yml

Setup local k8s Cluster​

./local_deployment/startup.sh -k
# Add Domain Entries
sudo sh -c "cat << 'EOF' >> /etc/hosts
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
EOF"

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