Sample manifest file for deploying LibreScan with Docker Compose.
The deployment depends on an external RPC endpoint which is exposed from an OpenEthereum compatible archive node.
LibreScan works with any OpenEthereum derivative blockchain node, which exposes the trace_* RPC namespace in a compatible manner. The node exposing the RPC endpoint must be running in full-archive mode. This can be a self-hosted node as well of course.
Some example node providers are:
LibreScan scrapes data off an RPC endpoint as described above.
This RPC endpoint needs to be passed as an ENV variable to the scraper service.
Once you have obtained your RPC endpoint URL (either from your own node or from a provider) replace the default one in the docker-compose.yml file.
Just run docker compose up -d.
If you want to observe the logs of the underlying services, execute docker compose logs -f afterwards.
The web interface will be made available at http://localhost:3000 by default.
If you are starting to sync a brand new instance, this will take days. This is not a LibreScan limitation, but generally blockchain sync time takes this much. Afterwards you will be kept up to date, and even relaunching after a couple weeks being offline will resync super quickly.