Welcome to CKAN’s Administration Guide

This Administration Guide covers how to set up and manage CKAN (Comprehensive Knowledge Archive Network) software.

• The first two sections cover your two options for installing CKAN: package or source install.
• The rest of the first half of the Guide, up to Set and Manage Permissions, cover setup and basic admin.
• The second half of the Guide, from Prepare to Use Extensions onwards, covers advanced tasks, including extensions and forms.

For high-level information on what CKAN is, see the CKAN website.

Contents:

• Option 1: Package Installation
  • Prepare your System
  • Run the Package Installer
• Option 2: Install from Source
  • Install the Source
• Post-Installation Setup
  • Create an Admin User
  • Load Test Data
  • Deployment
• Customization
  • Site Name and Description
  • Adding CSS, Javascript and other HTML using Config Options
  • More Advanced Customization
• Load Datasets
  • Import Data with the CKAN API
  • Import Data with the Harvester Extension
• Common CKAN Tasks
  • Understanding Paster
  • Common Tasks Using Paster
• Set and Manage Permissions
  • Overview
  • Default Permissions
  • Managing Permissions
  • Openness Modes
• Prepare to Use Extensions
• Add Extensions
  • Finding Extensions
  • Installing an Extension
  • Installing an Extension with Background Tasks
• Understand and Write Extensions
  • CKAN Extensions
  • Plugins
  • The Queue Extension
• Customizing Forms
  • Building a Dataset Form
• Form Integration
  • Redirecting CKAN Forms
• Database Dumps
  • Creating a Dump
  • Daily Dumps
  • Serving the Files
• Upgrade CKAN
• Internationalize CKAN
  • Supported Languages
  • Adding a New Language
• Reference: CKAN Configuration Options
  • Database Settings
  • Front-End Settings
  • Authentication Settings
  • Internationalisation Settings
  • Theming Settings
  • Form Settings
  • Messaging Settings
  • Search Settings
  • Site Settings
  • Authorization Settings
  • Plugin Settings
  • Directory Settings
• Reference: CKAN API
  • Overview
  • Examples
  • Code Modules for Client Applications
  • Versions
  • API Details - Versions 1 & 2
• Testing for Developers
  • Basic Tests
  • Testing against PostgreSQL
  • Migration Testing
  • Common error messages
• Common error messages
  • nose.config.ConfigError: Error reading config file 'setup.cfg': no such option 'with-pylons'
  • OperationalError: (OperationalError) no such function: plainto_tsquery ...
  • ImportError: No module named worker
  • ImportError: cannot import name get_backend
  • ImportError: cannot import name UnicodeMultiDict
  • nosetests: error: no such option: --ckan
  • AttributeError: 'unicode' object has no attribute 'items' (Cookie.py)
  • AttributeError: 'module' object has no attribute 'BigInteger'
  • ConfigParser.NoSectionError: No section: 'formatters'
  • ImportError: No module named exceptions
• Install Buildbot
  • Apt Installs
  • Postgres Setup
  • Buildslave Setup
  • Buildmaster Setup
  • Startup
  • Connect Ports
• About CKAN
  • Development
  • Acknowledgements
  • Copying and Licence

Other material

• CKAN CHANGELOG

Indices and tables

• Index
• Module Index
• Search Page