revamping readme with all latest info and docker-compose setup with traefik

This commit is contained in:
lza_menace 2020-07-03 21:29:55 -07:00
parent 0b3e02e022
commit 9946bacd98

View file

@ -1,11 +1,58 @@
## Wownero Explorer
Web interface for searching the Wownero blockchain.
A simple web interface for searching the Wownero blockchain.
## Running
## 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](https://wownero.com) 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](https://docs.traefik.io/getting-started/concepts/) 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 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