12 Getting started
Paolo Iommarini edited this page 2026-06-10 07:48:21 +00:00

Getting started

The easiest way to run piBlog is to use the published docker image and start it using a docker-compose file.
In the docker-compose file you can set platform settings using ENV variables to customize your installation.

After you have prepared your docker-compose start piBlog with the command

docker compose up -d

and your installation should be reachable at http://localhost:8080
You can login using the username and password defined in OwnerUsername and OwnerPassword

Docker compose using SQLite database

services:
  app:
    container_name: 'piBlog'  
    restart: unless-stopped
    image: paoloiommarini/piblog
    environment:
      DatabaseType: 'SQLite'
      OwnerUsername: 'admin'
      OwnerPassword: 'password'
    volumes:
      - piblog_data:/app/data
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 60s
      timeout: 5s
      retries: 3
      start_period: 10s  

volumes:
  piblog_data:

Docker compose using PostgreSQL database

services:
  app:
    container_name: 'piBlog'  
    restart: unless-stopped
    image: paoloiommarini/piblog
    environment:
      DatabaseType: 'Npgsql'
      DatabaseConnectionString: "Host=db;Port=5432;Database=piblog;Username=piblog_user;Password=piblog_pass"
      OwnerUsername: 'admin'
      OwnerPassword: 'password'
    volumes:
      - piblog_data:/app/data
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 60s
      timeout: 5s
      retries: 3
      start_period: 10s      
    depends_on:
      db:
        condition: service_started      
      
  db:
    image: postgres:latest
    container_name: piblog-db
    environment:
      POSTGRES_DB: piblog
      POSTGRES_USER: piblog_user
      POSTGRES_PASSWORD: piblog_pass
    volumes:
      - pgdata:/var/lib/postgresql/data
    expose:
      - "5432"      
      
volumes:
  pgdata:      
  piblog_data: