CKAN: Getting Started for Development
Prerequisites
CKAN has a rich tech stack so we have opted to standardize our instructions with Docker Compose, which will help you spin up every service in a few commands.
If you already have Docker-compose, you are ready to go!
If not, please, follow instructions on how to install docker-compose.
On Ubuntu you can run:
sudo apt-get update
sudo apt-get install docker-compose
Cloning the repo
git clone https://github.com/okfn/docker-ckan
# or git clone [email protected]:okfn/docker-ckan.git
cd docker-ckan
Booting CKAN
Create a local environment file:
cp .env.example .env
Build and Run the instances:
'docker-compose' must be run with 'sudo'. If you want to change this, you can follow the steps below. NOTE: The 'docker' group grants privileges equivalent to the 'root' user.
Create the docker group: sudo groupadd docker
Add your user to the docker group: sudo usermod -aG docker $USER
Change the storage directory ownership from root to ckan by adding the commads below to the ckan/Dockerfile.dev
RUN mkdir -p /var/lib/ckan/storage/uploads
RUN chown -R ckan:ckan /var/lib/ckan/storage
At this point, you can log out and log back in for these changes to apply. You can also use the command newgrp docker to temporarily enable the new group for the current terminal session.
docker-compose -f docker-compose.dev.yml up --build
When you see this log message:
You can navigate to http://localhost:5000
and log in with the credentials that docker-compose setup created for you [user: ckan_admin password:test1234].
To learn key concepts about CKAN, including what it is and how it works, you can read the User Guide.
Next Steps
Troubleshooting
Login / Logout button breaks the experience:
- Change the URL from
http://ckan:5000tohttp://localhost:5000. A complete fix is described in the Play around with CKAN portal. (Your next step. ;))