fractal-bitcoin / fractald-release

184 stars 53 forks source link

add additional steps for running in docker #24

Open starcox64 opened 1 month ago

starcox64 commented 1 month ago

I think it would be helpful to add the following to the readme:

starcox64 commented 1 month ago

You can replace the Using Docker section with the below. I think it's really helpful to spell out each step to remove barriers for less technical users who would like to run nodes.

Using Docker:

  1. Make sure you have Docker installed and running. You can install the latest release here.

  2. Clone the repository:

git clone https://github.com/fractal-bitcoin/fractald-release.git
  1. Navigate to the Docker directory:
cd fractald-docker
  1. Start the service with Docker Compose:
docker-compose up -d
  1. To open an interactive shell inside the Docker container:
docker exec -it fractald-docker-bitcoind-1 bash
  1. Once inside the container, you can start Fractal node. To start the container:
bitcoind

or to start the node in the background:

bitcoind -daemon
morismc09 commented 1 month ago

You can replace the Using Docker section with the below. I think it's really helpful to spell out each step to remove barriers for less technical users who would like to run nodes.

Using Docker:

  1. Make sure you have Docker installed and running. You can install the latest release here.
  2. Clone the repository:
git clone https://github.com/fractal-bitcoin/fractald-release.git
  1. Navigate to the Docker directory:
cd fractald-docker
  1. Start the service with Docker Compose:
docker-compose up -d
  1. To open an interactive shell inside the Docker container:
docker exec -it fractald-docker-bitcoind-1 bash
  1. Once inside the container, you can start Fractal node. To start the container:
bitcoind

or to start the node in the background:

bitcoind -daemon

For me this did not work. I always received the following error message:

 ✔ Container fractald-docker-bitcoind-1  Created                                                                                               0.0s 
Attaching to bitcoind-1
bitcoind-1  | Error: Failed saving settings file:
bitcoind-1  | - Error: Unable to open settings file /data/settings.json.tmp for writing
bitcoind-1  | 
bitcoind-1 exited with code 1
starcox64 commented 1 month ago

You can replace the Using Docker section with the below. I think it's really helpful to spell out each step to remove barriers for less technical users who would like to run nodes. Using Docker:

  1. Make sure you have Docker installed and running. You can install the latest release here.
  2. Clone the repository:
git clone https://github.com/fractal-bitcoin/fractald-release.git
  1. Navigate to the Docker directory:
cd fractald-docker
  1. Start the service with Docker Compose:
docker-compose up -d
  1. To open an interactive shell inside the Docker container:
docker exec -it fractald-docker-bitcoind-1 bash
  1. Once inside the container, you can start Fractal node. To start the container:
bitcoind

or to start the node in the background:

bitcoind -daemon

For me this did not work. I always received the following error message:

 ✔ Container fractald-docker-bitcoind-1  Created                                                                                               0.0s 
Attaching to bitcoind-1
bitcoind-1  | Error: Failed saving settings file:
bitcoind-1  | - Error: Unable to open settings file /data/settings.json.tmp for writing
bitcoind-1  | 
bitcoind-1 exited with code 1

When I started mine over from scratch last night, I ran into the same issue. I wonder if the docker image changed. I can't start the node in docker anymore at all.