Skip to main content

Provides basic multi-tenancy features for OpenWISP 2 (using the Django web-framework)

Project description Requirements Status

Provides basic multi-tenancy features for OpenWISP 2 (using the Django web-framework).

Deploy it in production

An automated installer is available at ansible-openwisp2.

Install stable version from pypi

Install from pypi:

pip install openwisp-users

Install development version

Install tarball:

pip install

Alternatively you can install via pip using git:

pip install -e git+git://

If you want to contribute, install your cloned fork:

git clone<your_fork>/openwisp-users.git
cd openwisp-users
python develop

Setup (integrate in an existing django project)

INSTALLED_APPS in should look like the following:


also add AUTH_USER_MODEL and SITE_ID to your

AUTH_USER_MODEL = 'openwisp_users.User'

from django.conf.urls import include, url
from django.contrib import admin
from django.contrib.staticfiles.urls import staticfiles_urlpatterns

urlpatterns = [
    url(r'^admin/', include(,
    url(r'^accounts/', include('allauth.urls')),

urlpatterns += staticfiles_urlpatterns()

For additional steps to properly configure allauth in your project, please refer to their documentation: allauth documentation installation section.

Installing for development

Install sqlite:

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

Install your forked repo:

git clone git://<your_fork>/openwisp-users
cd openwisp-users/
python develop

Install test requirements:

pip install -r requirements-test.txt

Create database:

cd tests/
./ migrate
./ createsuperuser

Set EMAIL_PORT in to a port number (eg: 1025):

EMAIL_PORT = '1025'

Launch development server and SMTP debugging server:

./ runserver
# open another terminal and run
python -m smtpd -n -c DebuggingServer localhost:1025

You can access the admin interface at

Run tests with:



  1. Announce your intentions in the OpenWISP Mailing List
  2. Fork this repo and install it
  3. Follow PEP8, Style Guide for Python Code
  4. Write code
  5. Write tests for your code
  6. Ensure all tests pass
  7. Ensure test coverage does not decrease
  8. Document your changes
  9. Send pull request





Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openwisp-users, version 0.1.10
Filename, size File type Python version Upload date Hashes
Filename, size openwisp_users-0.1.10-py2.py3-none-any.whl (17.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size openwisp-users-0.1.10.tar.gz (14.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page