Changing and reloading rules

Rules are cached

In order to avoid the reload of rules on each request the rules are cached on the first load from the middleware. This also means that if the rule are changed they have to be re-loaded somehow into the middleware.

One possibility is to just restart your server after you change the rules. In case this is acceptable for you just set the following variable into your settings file:


The second possibility (which is the default behaviour) is to request a rule reload. The next time the middleware will receive a request the rules will be reloaded. There is a custom management command for reloading rules:

$ ./ reload_rules

The advantage of this approach is that you don’t have to restart your server every time you change your rules. The disadvantage is that on each request a query will be executed that selects the first row from the reloadrulesrequest DB table.

As a more convenient alternative you can also visit the https://YOUR_DOMAIN/PATH_BEFORE_IPRESTRICT/iprestrict/reload_rules URL as a Django superuser to reload the rules.

Changing the rules on a production server

In case you are using the default caching described above, remember that every time you change your rules you will have to follow up with running the reload_rules command.

However, the recommended way of changing your restriction rules is to make the changes using admin on a staging server and test them there, export them and then import them on the production server instead of changing rules directly on the production server.

After you changed the rules and are happy with them you can export them using:

$ ./ dumpdata iprestrict --indent=4 --exclude iprestrict.ReloadRulesRequest > new_rules.json

Then you can copy the new_rules.json file to your production server and import them with the custom management command import_rules. For example if you’ve copied your rules file to /tmp you would use:

$ ./ import_rules /tmp/new_rules.json

You would also have to reload the rules or restart the server (depending on what caching strategy you are using):

$ ./ reload_rules

Or again, as an alternative just visit the iprestrict/reload_rules URL as mentioned above.