Developer Installation Instructions

Note

This page is for developers who want to customize or extend OpenWISP IPAM, whether for bug fixes, new features, or contributions.

For user guides and general information, please see:

Installing for Development 

Install sqlite:

sudo apt-get install sqlite3 libsqlite3-dev openssl libssl-dev

Install your forked repo:

git clone git://github.com/<your_fork>/openwisp-ipam
cd openwisp-ipam/
pip install -e .

Install test requirements:

pip install -r requirements-test.txt

Create database:

cd tests/
./manage.py migrate
./manage.py createsuperuser

Launch development server:

./manage.py runserver

You can access the admin interface at http://127.0.0.1:8000/admin/.

Run tests with:

# --parallel and --keepdb are optional but help to speed up the operation
./runtests.py --parallel --keepdb

To install the latest Pypi:

pip install openwisp-ipam

To install the latest development version tarball via HTTPs:

pip install https://github.com/openwisp/openwisp-ipam/tarball/master

Alternatively you can use the git protocol:

pip install -e git+git://github.com/openwisp/openwisp-ipam#egg=openwisp_ipam