Skip to main content

A way of allowing subdomains to be served by the same project, and associating objects with particular subdomains.

Project description

A simple way of allowing subdomains to be served by the same project, and associating objects with particular subdomains.


  1. By default, it will work if you use (a domain that points to localhost) on port 80. To use a different base domain/port, set the BASE_HOST and/or BASE_PORT variables.
  2. Add instances to your INSTALLED_APPS and migrate to get the Instance database table.
  3. Add Instance objects, with the label being the subdomain you wish to use. Optionally, associate users with these instances.
  4. Add instances.middleware.MultiInstanceMiddleware to your middleware; it must come after AuthenticationMiddleware. Now if you go to <subdomain>.<BASE_HOST>, request.instance will be set to the matching Instance object. If there’s a subdomain given but no match, it will redirect to BASE_HOST.

Requests to a subdomain will use your ROOT_URLCONF file; requests to the BASE_HOST will use ROOT_URLCONF_HOST or instances.urls by default (which just has one page that lists all instances)..

Instance edit form

In your ROOT_URLCONF, use a line like the following to have a page for editing the title and description of an instance:

url(r’^instance/edit$’, InstanceUpdate.as_view(), name=’instance-edit’)

Associating models

To have a model’s objects be associated with an instance, mix in InstanceMixin, and if you have a custom manager make it a subclass of InstanceManager. This adds an instance field, and provides a for_instance manager method to return all the objects in the given instance.

Mix in InstanceViewMixin to any display class-based view to restrict the default queryset to the request’s instance. Add InstanceFormMixin to any create/update view to store the current instance upon save, and allow editing only by those users associated with the instance. Remember to exclude instance from any model form, as it won’t be seen.

Running tests

pip install .

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 django-subdomain-instances, version 3.0.2
Filename, size File type Python version Upload date Hashes
Filename, size django_subdomain_instances-3.0.2-py2.py3-none-any.whl (13.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size django-subdomain-instances-3.0.2.tar.gz (9.7 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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page