Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Kepler-Explorer is the first block explorer for the Kepler blockchain. This is the source code for the instance running at

I hope it provides a useful service for anybody interested in Kepler and to its development.

Bugs, Feature Requests, etc.

Please report bugs, feature requests or feedback here.


kepler-explorer is licensed under the terms of the GNU AGPL 3, see the file LICENSE for details. Basically it allows you to use and modify this code as long as you make all changes available under the same terms. The easiest way to do this is to fork this repo (publically!) and deploy your instance from that repo.p

How to setup your own instance


Python >= 3.5 and PostgreSQL >= 9.3 are required.

Kepler is required to run as an archival node and basic auth needs to be disabled in its REST API. Set `archive_mode = true` and comment out `api_secret_path` in `kepler-server.toml` respectively.


Start PostgreSQL. Note that the following is just an example to run PostgreSQL, you should ensure you use your own user and credentials when setting it up.

sudo postgresql-setup --initdb
sudo systemctl start postgresql
sudo -u postgres -i
# psql
postgres=# \password postgres
Enter new password:
Enter it again:
postgres=# CREATE USER myuser WITH PASSWORD 'mypass';
postgres=# CREATE DATABASE mydb;
postgres=# GRANT ALL PRIVILEGES ON DATABASE mydb to myuser;
postgres=# \q
sudo systemctl restart postgresql

Start `kepler-explorer`. Again, ensure you use your own credentials for Django.

git clone
cd kepler-explorer
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# SECRET_KEY is required by Django
export SECRET_KEY=somesecretkey
# PostgreSQL configuration
export DB_NAME=mydb
export DB_USER=myuser
export DB_PASSWORD=mypass
export DB_HOST=
export DB_PORT=5432
python3 ./keplerexplorer/ migrate
python3 ./keplerexplorer/ runserver

Import blockchain

python3 ./keplerexplorer/ import_from_tip
You can’t perform that action at this time.