Prepare to Use ExtensionsΒΆ

If you are running a package installation of CKAN, before you start using and testing extensions (described in Add Extensions) you need to prepare your system.

Firstly, you’ll need to set up and enter a virtual Python environment, as follows:

sudo apt-get install python-virtualenv mercurial
virtualenv /home/ubuntu/pyenv
. /home/ubuntu/pyenv/bin/activate

Then, you need to install the CKAN source into your virtual environment. You can install CKAN like this:

pip install -e hg+http://bitbucket.org/okfn/ckan#egg=ckan

Your new CKAN developer install will be running on http://localhost:5000/

When you start using extensions, you should install any of the developer versions of the CKAN extensions you want to work on like this (using the appropriate URL):

pip install -e hg+http://bitbucket.org/okfn/<dependency-name>@<version>#egg=<egg-name>

The dependency you’ve installed will appear in /home/ubuntu/pyenv/src/ where you can work on it.

After working on extensions, you should make sure that your deployment passes the tests, as described in Testing for Developers.

Project Versions

Previous topic

Set and Manage Permissions

Next topic

Add Extensions

This Page