# CKAN Base XLoader

CKAN Base XLoader is a self-hosted databases app. Docker image of CKAN, an open-data catalog platform, pre-configured with the XLoader extension (a faster, more robust DataPusher replacement) for ingesting CSV and tabular data into CKAN's DataStore. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5631/ckan-base-xloader

## Description

Docker image of CKAN, an open-data catalog platform, pre-configured with the XLoader extension (a faster, more robust DataPusher replacement) for ingesting CSV and tabular data into CKAN's DataStore.

## Platform availability

Available on 0 of 10 platforms.

## Health score

57/100 (Fair), based on 5 of 5 factors.
- Maintained: 87 (last commit 44 days ago)
- Popular: 35 (58 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 74 (no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 5.1/10)

## Links

- Docker Hub: https://hub.docker.com/r/ckan/ckan-base-xloader
- GitHub: https://github.com/ckan/ckanext-xloader

## Common questions

### What database setup must I do before using the CKAN image?

Create a PostgreSQL database and user for CKAN and allow CKAN's IP address to connect with a password. Without this, CKAN cannot save datasets, users, or settings.

### What Solr requirement affects dataset search after first startup?

Start Solr and create a core named ckan before first use. If this is missing, CKAN's dataset search and list pages may fail or show no results.

### How should I store uploaded CKAN resources so they survive restarts?

Set the CKAN file storage path to a persistent folder before starting the app. A temporary or empty path can cause uploaded resources and files to disappear when the instance is restarted or rebuilt.

### Which process runs the XLoader jobs?

The worker process is ckan -c /etc/ckan/default/ckan.ini jobs worker. It is discussed as ideally running in its own container so CKAN is also installed.

### Why does this image include XLoader?

XLoader loads CSV and similar data into CKAN's DataStore and is designed as a replacement for DataPusher. The image is for experimentation with replacing DataPusher with XLoader.

---
Source: Our Local Host (https://ourlocalhost.com/app/5631/ckan-base-xloader), the self-hosted and open-source app directory.
