Website: update BP and docker usage doc

Author: dannywillems

website/docs/node-operators/block-producer.md

@@ -11,46 +11,88 @@ complete.
 Ensure Docker and Docker Compose are installed on your system -
 [Docker Installation Guide](../appendix/docker-installation)
 
-## Download & Start the Node
+## Using Docker Compose
 
-1. **Download the Latest Release**
+1. **Download the Docker Compose File**
 
-- Visit the [Mina Rust Releases](https://github.com/o1-labs/mina-rust/releases)
-- Download the latest `mina-rust-vX.Y.Z-docker-compose.zip`
-- Extract the Files:
+   Create a directory for your block producer and download the docker-compose
+   file:
 
-  ```bash
-  unzip mina-rust-vX.Y.Z-docker-compose.zip
-  cd mina-rust-vX.Y.Z-docker-compose
-  mkdir mina-workdir
-  ```
+   ```bash
+   # Create a directory for your block producer
+   mkdir mina-block-producer && cd mina-block-producer
+
+   # Create the working directory for node data
+   mkdir mina-workdir
+
+   # Download the block producer docker-compose file (choose one method)
+   # Using wget:
+   wget https://raw.githubusercontent.com/o1-labs/mina-rust/v0.17.0/docker-compose.block-producer.yml
+
+   # Or using curl:
+   curl -O https://raw.githubusercontent.com/o1-labs/mina-rust/v0.17.0/docker-compose.block-producer.yml
+
+   # Create an empty .env file to avoid warnings (optional - has defaults)
+   touch .env
+   ```
+
+   For the latest development version, replace `v0.17.0` with `develop` in the
+   URL.
+
+2. **Verify Docker Image Version** (Optional but recommended)
 
-2. **Prepare Your Keys**
+   Before starting, verify you have the correct version:
+
+   ```bash
+   docker run --rm o1labs/mina-rust:latest build-info
+   ```
+
+   This shows the exact version, commit hash, and build details.
+
+3. **Prepare Your Keys**
 
    [Docker Compose](https://github.com/o1-labs/mina-rust/blob/develop/docker-compose.block-producer.yml)
    references `mina-workdir`. It stores a private key and logs for block
    production.
 
    **Option A: Generate a new key pair (if you don't have one)**
 
-   If you don't have a block producer key, you can generate one using the
-   Makefile target:
+   If you don't have a block producer key, you can generate one using the Mina
+   CLI:
 
    ```bash
-   # Clone the repository first if you haven't already
-   git clone https://github.com/o1-labs/mina-rust.git
-   cd mina-rust
-
-   # Generate a new encrypted key pair
-   make generate-block-producer-key
+   # Generate a new encrypted key pair using Docker
+   # This creates the key directly in the mina-workdir/producer-key file
+   docker run --rm -v $(pwd)/mina-workdir:/root/.mina o1labs/mina-rust:latest \
+     misc mina-encrypted-key "YourPassword" --file /root/.mina/producer-key
 
-   # Or generate with a password
-   make generate-block-producer-key MINA_PRIVKEY_PASS="YourPassword"
+   # Fix file permissions to match your local user (recommended)
+   sudo chown $(id -u):$(id -g) mina-workdir/producer-key
    ```
 
-   This will create:
-   - `mina-workdir/producer-key` (encrypted private key)
-   - `mina-workdir/producer-key.pub` (public key)
+   This will create an encrypted private key file at
+   `mina-workdir/producer-key`. The key will be encrypted with the password you
+   provide.
+
+   <!-- prettier-ignore-start -->
+
+   :::tip File Permissions
+
+   Docker containers typically run as root, so generated files will be owned by
+   root. It's recommended to change ownership to your local user using `chown`
+   after generation to avoid permission issues when accessing or backing up the
+   key file.
+
+   :::
+   <!-- prettier-ignore-stop -->
+
+   The command also outputs the public key which you should save for reference:
+
+   ```bash
+   # To see just the public key, you can run:
+   docker run --rm -v $(pwd)/mina-workdir:/root/.mina o1labs/mina-rust:latest \
+     misc mina-encrypted-key "YourPassword" --file /root/.mina/producer-key | grep "Public key:"
+   ```
 
    **Option B: Use an existing key**
 
@@ -64,7 +106,7 @@ Ensure Docker and Docker Compose are installed on your system -
    Replace `/path/to/your/private_key` with the actual path to your private key
    file.
 
-3. **Launch Block Producer**
+4. **Launch Block Producer**
 
    Use `MINA_PRIVKEY_PASS` to set the private key password. Optionally, use
    `COINBASE_RECEIVER` to set a different coinbase receiver:
@@ -98,11 +140,24 @@ Ensure Docker and Docker Compose are installed on your system -
    docker compose -f docker-compose.block-producer.yml up -d --pull always
    ```
 
-4. **Go to Dashboard**
+5. **Go to Dashboard**
+
+   Visit [http://localhost:8070](http://localhost:8070) to monitor sync and
+   block production.
+
+   <!-- prettier-ignore-start -->
+
+   :::note Frontend Status
+
+   The dashboard is currently being updated and may not work correctly in
+   v0.17.0. As an alternative, monitor your node using logs:
+
+   ```bash
+   docker compose logs -f
+   ```
 
-   Visit [http://localhost:8070](http://localhost:8070) to
-   [monitor sync](http://localhost:8070/dashboard) and
-   [block production](http://localhost:8070/block-production).
+   :::
+   <!-- prettier-ignore-stop -->
 
 ## Using Make Command
 

website/docs/node-operators/docker-usage.md

@@ -147,7 +147,7 @@ docker run -p 8302:8302 o1labs/mina-rust:latest
 
 ```bash
 # Run node and web dashboard together
-docker run -d --name mina-node -p 8302:8302 o1labs/mina-rust:latest \
+docker run -d --name mina-rust-node -p 8302:8302 o1labs/mina-rust:latest \
   node --network devnet
 # Frontend (currently being fixed, may not work as expected)
 docker run -d --name mina-frontend -p 8070:8070 o1labs/mina-rust-frontend:latest
@@ -170,6 +170,44 @@ operational in a future release.
 
 <!-- prettier-ignore-stop -->
 
+#### Quick Start with Release Version
+
+For each release, you can directly download the docker-compose.yml file:
+
+```bash
+# Create a directory for your Mina node
+mkdir mina-rust-node && cd mina-rust-node
+
+# Download the docker-compose.yml file (choose one method)
+# Using wget:
+wget https://raw.githubusercontent.com/o1-labs/mina-rust/v0.17.0/docker-compose.yml
+
+# Or using curl:
+curl -O https://raw.githubusercontent.com/o1-labs/mina-rust/v0.17.0/docker-compose.yml
+
+# Create an empty .env file to avoid warnings (optional - has defaults)
+touch .env
+
+# Or create .env with custom settings (optional)
+cat > .env << EOF
+MINA_RUST_TAG=latest
+MINA_FRONTEND_TAG=latest
+MINA_LIBP2P_PORT=8302
+EOF
+
+# Start the node
+docker compose up -d
+
+# View logs
+docker compose logs -f
+
+# Stop services
+docker compose down
+```
+
+#### Using Latest Development Version
+
+To use the latest development version with all configuration files:
 
 ```bash
 # Clone the repository to get the docker compose configuration
@@ -203,7 +241,7 @@ MINA_LIBP2P_PORT=9302 MINA_LIBP2P_EXTERNAL_IP=203.0.113.1 docker compose up -d
 
 #### What's Included
 
-- **mina-node**: The core Mina Rust node running on devnet
+- **mina-rust-node**: The core Mina Rust node running on devnet
 - **frontend**: Web dashboard accessible at http://localhost:8070 (currently
   being fixed)
 - **Persistent storage**: Node data stored in `./mina-workdir` directory
@@ -220,21 +258,37 @@ MINA_LIBP2P_PORT=9302 MINA_LIBP2P_EXTERNAL_IP=203.0.113.1 docker compose up -d
 
 ```bash
 # Run with custom verbosity
-docker run -d --name mina-node \
+docker run -d --name mina-rust-node \
   -p 8302:8302 \
   o1labs/mina-rust:latest \
   node --network devnet --verbosity debug
 
 # Run with external IP and custom libp2p port
 # Get your external IP first
 EXTERNAL_IP=$(curl -s https://ifconfig.me/ip)
-docker run -d --name mina-node \
+docker run -d --name mina-rust-node \
   -p 9302:9302 \
   -e MINA_LIBP2P_EXTERNAL_IP=$EXTERNAL_IP \
   o1labs/mina-rust:latest \
   node --network devnet --libp2p-port 9302
 ```
 
+### Verifying Docker Image Version
+
+Always verify the version of your Docker image to ensure you're running the
+correct build:
+
+```bash
+# Check build information
+docker run --rm o1labs/mina-rust:latest build-info
+
+# For a specific version
+docker run --rm o1labs/mina-rust:v0.17.0 build-info
+```
+
+This displays version details including commit hash, build time, and Rust
+compiler version. See [Node Management](node-management) for more details.
+
 ## Next Steps
 
 For specific node configurations and detailed setup guides: