d0s3t3ch/wownero-explorer
1
0
Fork 0
mirror of https://git.wownero.com/lza_menace/wownero-explorer.git synced 2024-08-15 01:03:26 +00:00
Code Issues Projects Releases Wiki Activity
Web interface for searching the Wownero blockchain.
24 commits 1 branch 0 tags 86 KiB
CSS 75%
Rust 23.5%
Dockerfile 1.5%
Find a file
lza_menace 50bf259e8d use the .org
2020-07-05 00:48:54 -07:00
src adding debug, accounting for mined/cb txes 2020-07-05 00:06:50 -07:00
static/css adding debug, accounting for mined/cb txes 2020-07-05 00:06:50 -07:00
templates use the .org 2020-07-05 00:48:54 -07:00
.dockerignore adding the docker bits to get ready to serve it for real 2020-07-03 01:32:18 -07:00
.gitignore ignore data dir for traefik tls state 2020-07-03 21:30:43 -07:00
Cargo.lock rust and project meta 2020-07-01 01:10:12 -07:00
Cargo.toml streamlining container image builds with hacky dummy file 2020-07-03 21:00:30 -07:00
docker-compose.example.yml adding the docker bits to get ready to serve it for real 2020-07-03 01:32:18 -07:00
docker-compose.yml updating compose file with full traefik config for dev 2020-07-03 21:29:38 -07:00
Dockerfile use a default cmd to start web server 2020-07-03 21:26:25 -07:00
dummy.rs streamlining container image builds with hacky dummy file 2020-07-03 21:00:30 -07:00
README.md fix minor typo in readme 2020-07-03 21:32:10 -07:00

README.md

Wownero Explorer

A simple web interface for searching the Wownero blockchain.

Quick-Start

Docker

The fastest way to get it up and running to test it locally is to use the pre-made Docker container:

export DAEMON_URI=http://so.wow.candy.surf:34568
docker run -d \
    --name wownero-explorer \
    --rm \
    -p 80:8000 \
    -e DAEMON_URI=$DAEMON_URI \
    lalanza808/wownero-explorer:latest

You could also just use docker-compose, though it will download a reverse proxy image:

export DAEMON_URI=http://so.wow.candy.surf:34568
docker-compose up -d

Navigate to http://localhost/ to browse the explorer.

Rust

Alternatively, if you'd like to build/run using native Rust tools, follow these steps:

  1. Install Rust: https://www.rust-lang.org/tools/install
  2. Clone this repo: git clone https://git.wownero.com/lza_menace/wownero-explorer && cd wownero-explorer
  3. Pin the nightly version of rust to the local directory: rustup override set nightly
  4. Pick a Wownero node if you don't have one and apply the DAEMON_URI environment variable: export DAEMON_URI=http://so.wow.candy.surf:34568
  5. Run the application: cargo run
  6. Navigate to http://localhost:8000/

Full Installation

I'm using Traefik as a reverse proxy in order to handle automatic TLS certification with Let's Encrypt and to avoid manage Nginx configs. If you want to run the full installation you will need a registered domain and control of DNS records.

I don't feel like paying for a cluster for this simple app so I'm using docker-compose on a single box that I can recreate easily and often to avoid config drift.

  1. Create new file, docker-compose.prod.yml as a copy of docker-compose.yml
  2. Uncomment labels under wownero-explorer service
  3. Change labels to match external DNS name
  4. Set ${ACME_EMAIL} either as hardcoded string or pass as environment variable
  5. Run docker-compose -f docker-compose.prod.yml up -d

Questions?

Ask around in IRC: https://webchat.freenode.net/?room=#wownero