Navigation

• Installation
• Front-end Development
• Datasets Upload
• Datasets Update

Installation

We are using a virtual machine instance with Debian 12 (Bookworm) as the operating system. The instance is configured with 8 vCPUs and 32 GB of memory (RAM).

Environment (Not minimum requirement; only recommended)

• Installing Composer
• Installing DDEV
• Installing Docker

MySQL: 8.4.2
PHP: 8.3.11
Apache: 2.4.59
Node: 22.8.0

Build Project BACKEND

ddev start
ddev composer install
ddev dkan-site-install

Build Project FRONTEND

ddev dkan-frontend-install

Enter N for the following prompt:

replace docroot/data-catalog-app-1.6.2/.circleci/config.yml? [y]es, [n]o, [A]ll, [N]one, [r]ename:

ddev dkan-frontend-build

Run Cron Jobs

ddev drush cron

Generate a one-time login link

// get a local url
ddev drush uli
// get a external url
ddev drush uli | sed "s|https://get-dkan.ddev.site|http://$(curl -s ifconfig.me):8080|g"
ddev launch

(Optional) On the cloud: Login as the admin user and launch the application

sudo usermod -aG docker $USER
newgrp docker
sudo chown -R $USER:$USER /home/get-dkan

Flask Proxy

Requirement

Python Version 3.7 or later.

Proxy Execution

docker exec -it ddev-get-dkan-web /bin/bash
setsid /venv/bin/python proxy.py &

(Optional) Generate certificates locally

mkcert 127.0.0.1 localhost

Front-end Development

git pull
ddev dkan-frontend-build

(Optional) Datasets Upload

ddev drush queue:list
ddev drush queue:run localize_import
ddev drush queue:run datastore_import
ddev drush queue:run post_import

(Optional) Datasets Update

ddev drush queue:list
ddev drush queue:run resource_purger
ddev drush queue:run orphan_reference_processor