Blockbook Docker (Single Contianer)

This guide will help you build and run the Docker image for Blockbook Mainnet and Testnet, which is based on Ubuntu 22.04 and includes both backend and frontend components in single contianer.

Prerequisites

Docker installed on your machine.
Clone or download the repository to your local machine.

Mainnet

Steps to build the docker image for mainnet.

Building the Docker Image

Navigate to the directory where the repository is cloned or downloaded and build the docker image:
```
cd <path/to/cloned/repository>
docker build -t <imagename> .
```
Running the Docker Container

Create a named volume for Persistent storage using:
```
docker volume create <volume_name>
```
Run the Docker container in detached mode and for mainnet map port 9166 on your host to port 9166 on the container:
```
docker run -d -p 9166:9166 --mount source=<volume_name>,target=/opt/coins <imagename>
```
Accessing the Frontend

Once the Docker container is running, you can access the frontend of the application by navigating to:

https://localhost:9166

in your web browser.
Accessing Logs

To check the logs, you can access the container shell and use the tail command.

First, get the container's name or ID:
```
docker ps -a
```
Then, access the container shell:
```
docker exec -it <containername> bash
```
To view the logs of Backend and Frontend, run:
```
# Backend logs
tail -f /opt/coins/data/flo/backend/debug.log

# Frontend logs
tail -f /opt/coins/blockbook/flo/logs/blockbook.INFO
```

Testnet

Steps to build the docker image for Testnet.

Building the Docker Image

Navigate to the directory where the repository is cloned or downloaded and build the docker image:
```
cd <path/to/cloned/repository>
docker build -t <imagename> .
```
Running the Docker Container

Create a named volume for Persistent storage using:
```
docker volume create <volume_name>
```
Run the Docker container in detached mode and for mainnet map port 19166 on your host to port 19166 on the container:
```
docker run -d -p 19166:19166 --mount source=<volume_name>,target=/opt/coins <imagename>
```
Accessing the Frontend

Once the Docker container is running, you can access the frontend of the application by navigating to:

https://localhost:19166

in your web browser.

Accessing Logs

To check the logs, you can access the container shell and use the tail command.

First, get the container's name or ID:

docker ps -a

Then, access the container shell:

docker exec -it <containername> bash

To view the logs of Backend and Frontend, run:

# Backend logs
tail -f /opt/coins/data/flo_testnet/backend/testnet4/debug.log

# Frontend logs
tail -f /opt/coins/blockbook/flo_testnet/logs/blockbook.INFO

Additional Commands

Stopping the Docker Container:

To stop the container, use:
```
docker stop <containername>
```
Removing the Docker Container:

To remove the container, use:
```
docker rm <containername>
```
Removing the Docker Image:

To remove the image, use:
```
docker rmi <imagename>
```

Replace <path/to/cloned/repository>, <imagename>, and <containername> with the actual path, image name, and container name or ID, respectively.

Troubleshooting

Ensure that no other application is using port 9166 or 19166 on your host machine.
If you encounter issues, check the Docker container logs:
```
docker logs <containername>
```

3.9 KiB Raw Blame History