Add Docker Hub installation instructions and docker-compose.dockerhub.yml

Author: blink-zero

DOCKER.md

@@ -24,6 +24,8 @@ This document provides detailed instructions for setting up and configuring Powe
 
 ## Quick Start
 
+### Using Local Build
+
 1. Clone the repository:
    ```bash
    git clone https://github.com/blink-zero/powerpulse.git
@@ -53,6 +55,49 @@ This document provides detailed instructions for setting up and configuring Powe
 
 5. Access PowerPulse at http://localhost
 
+### Using Docker Hub Images
+
+You can also run PowerPulse directly from Docker Hub without cloning the repository:
+
+1. Create a directory for PowerPulse:
+   ```bash
+   mkdir powerpulse
+   cd powerpulse
+   ```
+
+2. Create a data directory for the server:
+   ```bash
+   mkdir -p server/data
+   ```
+
+3. Download the Docker Compose file:
+   ```bash
+   wget https://raw.githubusercontent.com/blink-zero/powerpulse/v1.8.2/docker-compose.dockerhub.yml -O docker-compose.yml
+   ```
+
+4. Create an environment file:
+   ```bash
+   wget https://raw.githubusercontent.com/blink-zero/powerpulse/v1.8.2/.env.example -O .env
+   ```
+
+5. Edit the `.env` file to set your configuration:
+   ```bash
+   # Generate a secure JWT secret
+   JWT_SECRET=$(openssl rand -hex 32)
+   # Replace the default value in .env
+   sed -i "s/JWT_SECRET=.*/JWT_SECRET=$JWT_SECRET/" .env
+   
+   # Edit other settings as needed
+   nano .env
+   ```
+
+6. Start the containers:
+   ```bash
+   docker-compose up -d
+   ```
+
+7. Access PowerPulse at http://localhost
+
 ## Configuration
 
 ### Environment Variables

README.md

@@ -121,6 +121,37 @@ powerpulse/
    docker-compose up -d
    ```
 
+#### Docker Hub Installation
+
+You can also run PowerPulse directly from Docker Hub without cloning the repository:
+
+1. Create a directory for PowerPulse:
+   ```
+   mkdir powerpulse
+   cd powerpulse
+   ```
+
+2. Create a data directory for the server:
+   ```
+   mkdir -p server/data
+   ```
+
+3. Download the Docker Compose file:
+   ```
+   wget https://raw.githubusercontent.com/blink-zero/powerpulse/v1.8.2/docker-compose.dockerhub.yml -O docker-compose.yml
+   ```
+
+4. Create an environment file:
+   ```
+   wget https://raw.githubusercontent.com/blink-zero/powerpulse/v1.8.2/.env.example -O .env
+   # Edit .env with your configuration
+   ```
+
+5. Start with Docker Compose:
+   ```
+   docker-compose up -d
+   ```
+
 ### Testing with Sample Data
 
 To generate test battery history data for development and testing:

docker-compose.dockerhub.yml

@@ -0,0 +1,70 @@
+version: '3.8'
+
+services:
+  server:
+    image: blinkzero/powerpulse-server:1.8.2
+    container_name: powerpulse-server
+    restart: unless-stopped
+    command: ["node", "server.js"]
+    ports:
+      - "5001:5000"
+    volumes:
+      - ./server/data:/app/data
+    environment:
+      - NODE_ENV=production
+      - PORT=5000
+      - TZ=${TZ:-UTC}
+      - JWT_SECRET=${JWT_SECRET:-change_this_to_a_secure_random_string}
+      - DEFAULT_NUT_HOST=${DEFAULT_NUT_HOST:-host.docker.internal}
+      - DEFAULT_NUT_PORT=${DEFAULT_NUT_PORT:-3493}
+      - DEFAULT_NUT_USERNAME=${DEFAULT_NUT_USERNAME:-}
+      - DEFAULT_NUT_PASSWORD=${DEFAULT_NUT_PASSWORD:-}
+      - NUT_CONNECTION_TIMEOUT=${NUT_CONNECTION_TIMEOUT:-5000}
+      - NUT_RETRY_ATTEMPTS=${NUT_RETRY_ATTEMPTS:-3}
+      - NUT_RETRY_DELAY=${NUT_RETRY_DELAY:-1000}
+      - LOG_LEVEL=${LOG_LEVEL:-info}
+      # Email configuration
+      - SMTP_HOST=${SMTP_HOST:-}
+      - SMTP_PORT=${SMTP_PORT:-}
+      - SMTP_USER=${SMTP_USER:-}
+      - SMTP_PASS=${SMTP_PASS:-}
+      - SMTP_FROM=${SMTP_FROM:-powerpulse@example.com}
+    healthcheck:
+      test: ["CMD", "sh", "-c", "wget --no-verbose --tries=1 --spider http://localhost:5000/api/auth/check-setup || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+    networks:
+      - powerpulse-network
+
+  client:
+    image: blinkzero/powerpulse-client:1.8.2
+    container_name: powerpulse-client
+    restart: unless-stopped
+    ports:
+      - "80:80"
+    depends_on:
+      server:
+        condition: service_healthy
+    environment:
+      - SERVER_HOST=server
+      - SERVER_PORT=5000
+      - TZ=${TZ:-UTC}
+      - ENABLE_HTTPS=${ENABLE_HTTPS:-false}
+    healthcheck:
+      test: ["CMD", "sh", "-c", "wget --no-verbose --tries=1 --spider http://localhost/health || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+    networks:
+      - powerpulse-network
+
+networks:
+  powerpulse-network:
+    driver: bridge
+
+volumes:
+  data:
+    driver: local