Piwigo

Key Features

• Automatic EXIF data extraction and display including camera settings, GPS coordinates, and shooting parameters
• Batch photo upload via web interface, FTP, or directory synchronization with automatic thumbnail generation
• Advanced user permission system with album-specific access controls and guest browsing options
• Plugin ecosystem with 300+ extensions including Lightroom synchronization, slideshow generators, and social sharing
• MariaDB Aria storage engine optimization for improved photo metadata indexing and search performance
• Watermark application with customizable positioning, transparency, and batch processing capabilities
• Mobile-responsive interface with touch-friendly navigation and optimized image loading
• Advanced search functionality across EXIF data, keywords, albums, and custom metadata fields

Common Use Cases

• 1Professional photography studios organizing client shoots with album-specific access permissions
• 2Family photo archives with multi-generational access and privacy controls for different album collections
• 3Real estate agencies managing property photo galleries with location-based organization and client access
• 4Educational institutions creating visual course materials and student project galleries
• 5Corporate media libraries for marketing teams managing brand assets and campaign photography
• 6Event photography businesses providing client galleries with download and sharing capabilities
• 7Historical societies digitizing and organizing archival photograph collections with metadata preservation

Prerequisites

• Minimum 1GB RAM for MariaDB database operations and photo thumbnail generation
• Available port 80 for web interface access or alternative port configuration
• Docker environment variables DB_ROOT_PASSWORD and DB_PASSWORD configured in .env file
• Sufficient storage space for original photos, generated thumbnails, and database growth
• Basic understanding of photo file formats and web gallery management concepts
• Network access planning for multi-user environments and potential reverse proxy integration

docker-compose.yml

1services: 
2  piwigo: 
3    image: lscr.io/linuxserver/piwigo:latest
4    container_name: piwigo
5    restart: unless-stopped
6    environment: 
7      PUID: 1000
8      PGID: 1000
9      TZ: UTC
10    volumes: 
11      - piwigo_config:/config
12      - piwigo_gallery:/gallery
13    ports: 
14      - "80:80"
15    depends_on: 
16      - mariadb
17    networks: 
18      - piwigo
19
20  mariadb: 
21    image: mariadb:10.11
22    container_name: piwigo-mariadb
23    restart: unless-stopped
24    environment: 
25      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
26      MARIADB_DATABASE: piwigo
27      MARIADB_USER: piwigo
28      MARIADB_PASSWORD: ${DB_PASSWORD}
29    volumes: 
30      - mariadb_data:/var/lib/mysql
31    networks: 
32      - piwigo
33
34volumes: 
35  piwigo_config: 
36  piwigo_gallery: 
37  mariadb_data: 
38
39networks: 
40  piwigo: 
41    driver: bridge

.env Template

1DB_ROOT_PASSWORD=rootpassword
2DB_PASSWORD=piwigo

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

piwigo:
  image: lscr.io/linuxserver/piwigo:latest
  container_name: piwigo
  restart: unless-stopped
  environment:
    PUID: 1000
    PGID: 1000
    TZ: UTC
  volumes:
    - piwigo_config:/config
    - piwigo_gallery:/gallery
  ports:
    - "80:80"
  depends_on:
    - mariadb
  networks:
    - piwigo

mariadb:
  image: mariadb:10.11
  container_name: piwigo-mariadb
  restart: unless-stopped
  environment:
    MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    MARIADB_DATABASE: piwigo
    MARIADB_USER: piwigo
    MARIADB_PASSWORD: ${DB_PASSWORD}
  volumes:
    - mariadb_data:/var/lib/mysql
  networks:
    - piwigo

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  piwigo:
5    image: lscr.io/linuxserver/piwigo:latest
6    container_name: piwigo
7    restart: unless-stopped
8    environment:
9      PUID: 1000
10      PGID: 1000
11      TZ: UTC
12    volumes:
13      - piwigo_config:/config
14      - piwigo_gallery:/gallery
15    ports:
16      - "80:80"
17    depends_on:
18      - mariadb
19    networks:
20      - piwigo
21
22  mariadb:
23    image: mariadb:10.11
24    container_name: piwigo-mariadb
25    restart: unless-stopped
26    environment:
27      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
28      MARIADB_DATABASE: piwigo
29      MARIADB_USER: piwigo
30      MARIADB_PASSWORD: ${DB_PASSWORD}
31    volumes:
32      - mariadb_data:/var/lib/mysql
33    networks:
34      - piwigo
35
36volumes:
37  piwigo_config:
38  piwigo_gallery:
39  mariadb_data:
40
41networks:
42  piwigo:
43    driver: bridge
44EOF
45
46# 2. Create the .env file
47cat > .env << 'EOF'
48DB_ROOT_PASSWORD=rootpassword
49DB_PASSWORD=piwigo
50EOF
51
52# 3. Start the services
53docker compose up -d
54
55# 4. View logs
56docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/piwigo/run | bash

Troubleshooting