To use Django-Cryptolock in a project, add it to your INSTALLED_APPS:


Now you should add the auth backend you wish to use on your project. You can use one or more:


If you use Monero, currently the following extra settings are required:

DJCL_MONERO_NETWORK = "mainnet"  # mainnet, stagenet or testnet
DJCL_MONERO_WALLET_RPC_HOST = "<wallet_rpc_host>:<port>"

For Bitcoin, you only need to set the DJCL_BITCOIN_NETWORK:

DJCL_BITCOIN_NETWORK = "mainnet"  # mainnet or testnet

Add Django-Cryptolock’s URL patterns:

from django.conf.urls import url

urlpatterns = [
    url(r"^auth/", include("django_cryptolock.urls", namespace="django_cryptolock")),

This will add 2 routes :

  • django_cryptolock:signup
  • django_cryptolock:login

For usega within you templates. For specific auth pages you can create the template files (login.html and signup.html) under a django_cryptolock subfolder.

Both of these templates will have access to a ``form```containing the required fields for the authentication.