### Install PiGallery2 from Release

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Downloads and installs PiGallery2 from a pre-built release zip file. This is a straightforward method for getting the application running.

```bash
wget https://github.com/bpatrik/pigallery2/releases/download/3.0.0/pigallery2-release.zip
unzip pigallery2-release.zip -d pigallery2
cd pigallery2
npm install
```

--------------------------------

### Install Docker

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

Installs Docker on a system, typically a Raspberry Pi, using a convenience script. This command downloads and executes the Docker installation script.

```bash
curl -sSL https://get.docker.com | sh
```

--------------------------------

### Install PiGallery2 from Source

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Installs PiGallery2 by cloning the source code and building it. This method requires more memory and time but allows for development or using the latest unreleased code.

```bash
wget https://github.com/bpatrik/pigallery2/archive/master.zip
unzip master.zip
cd pigallery2-master
npm install
npm run build
```

--------------------------------

### Install Dependencies

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/contributing.md

Installs the necessary project dependencies using npm.

```bash
npm install
```

--------------------------------

### Run PiGallery2 App

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Starts the PiGallery2 application after installation. Default credentials are admin/admin.

```bash
npm start
```

--------------------------------

### Server.ts Example with Imports

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/extensions.md

Example of a server.ts file demonstrating how to import types from the extension kit, external packages like lodash, and main app packages using relative paths for local dependencies.

```typescript
// Including dev-kit interfaces. It is not necessary, only helps development with types.
// You need to prefix them with ./node_modules
import { IExtensionObject } from "./node_modules/pigallery2-extension-kit";

// Including prod extension packages. You need to prefix them with ./node_modules
// lodash does not have types
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
// @ts-ignore
import * as _ from "./node_modules/lodash";

// Importing packages that are available in the main app (listed in the packages.json in pigallery2)
import { Column, Entity, Index, PrimaryGeneratedColumn } from "typeorm";
```

--------------------------------

### Recommended Extension Structure

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/extensions.md

The recommended setup includes an optional package.js for dependencies and a required server.js for extension logic.

```plaintext
<path to the extension fodler>/myextension/package.js <- this is optional. You can add extra npm packages here
<path to the extension fodler>/myextension/server.js <- this is needed
```

--------------------------------

### Set Configuration via CLI

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Example of how to set a configuration value, such as 'MyConf', directly from the command line.

```bash
<appname> --MyConf=5
```

--------------------------------

### Install Build Tools

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Installs essential build tools required for compiling native Node.js modules. Use this command on Debian-based systems.

```bash
sudo apt-get install build-essential libkrb5-dev gcc g++
```

--------------------------------

### Install Node.js

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Installs Node.js version 22.x using NodeSource repository. This ensures the correct Node.js version for PiGallery2.

```bash
curl -sL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

--------------------------------

### Minimal Extension Setup

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/extensions.md

A minimal PiGallery2 extension requires a server.js file exporting an init function.

```javascript
server.js
```

--------------------------------

### Create Configuration Directories

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/advanced/advanced-docker-npm-portainer.md

Create necessary directories for Nginx Proxy Manager and PiGallery2 configurations. This helps in organizing and backing up your setup.

```bash
mkdir -p ~/configs/nginx-proxy-manager/data
mkdir -p ~/configs/nginx-proxy-manager/letsencrypt
mkdir -p ~/configs/pigallery2/config
```

--------------------------------

### Start MariaDB Test Container

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/contributing.md

Start a MariaDB Docker container configured for Pigallery2 tests. This is required to run MySQL/MariaDB specific tests.

```bash
docker run --name pigallery_test -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=pigallery_test -e MYSQL_USER=user -e MYSQL_PASSWORD=password -p3306:3306 -d mariadb:10.3 --log-bin --binlog-format=MIXED
```

--------------------------------

### Install Docker Compose

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

Installs Docker Compose using pip3. This command installs the docker-compose package, which is used to manage multi-container Docker applications.

```bash
sudo pip3 install docker-compose
```

--------------------------------

### Map Path Group Configuration Example

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Defines how map markers are grouped and themed. This example includes configurations for 'Transportation' (flight, drive, ship) and 'Sport' (run, walk, hike, bike) categories, each with specific matching rules and visual themes.

```json
[{"name":"Transportation","matchers":[{"matchers":["flight","flying"],"theme":{"color":"var(--bs-orange)","dashArray":"4 8","svgIcon":{"viewBox":"0 0 567 512","items":"<path d=\"M482.3 192c34.2 0 93.7 29 93.7 64c0 36-59.5 64-93.7 64l-116.6 0L265.2 495.9c-5.7 10-16.3 16.1-27.8 16.1l-56.2 0c-10.6 0-18.3-10.2-15.4-20.4l49-171.6L112 320 68.8 377.6c-3 4-7.8 6.4-12.8 6.4l-42 0c-7.8 0-14-6.3-14-14c0-1.3 .2-2.6 .5-3.9L32 256 .5 145.9c-.4-1.3-.5-2.6-.5-3.9c0-7.8 6.3-14 14-14l42 0c5 0 9.8 2.4 12.8 6.4L112 192l102.9 0-49-171.6C162.9 10.2 170.6 0 181.2 0l56.2 0c11.5 0 22.1 6.2 27.8 16.1L365.7 192l116.6 0z"/>"}}},{"matchers":["drive","driving"],"theme":{"color":"var(--bs-orange)","dashArray":"4 8","svgIcon":{"viewBox":"0 0 640 512","items":"<path d=\"M171.3 96H224v96H111.3l30.4-75.9C146.5 104 158.2 96 171.3 96zM272 192V96h81.2c9.7 0 18.9 4.4 25 12l67.2 84H272zm256.2 1L428.2 68c-18.2-22.8-45.8-36-75-36H171.3c-39.3 0-74.6 23.9-89.1 60.3L40.6 196.4C16.8 205.8 0 228.9 0 256V368c0 17.7 14.3 32 32 32H65.3c7.6 45.4 47.1 80 94.7 80s87.1-34.6 94.7-80H385.3c7.6 45.4 47.1 80 94.7 80s87.1-34.6 94.7-80H608c17.7 0 32-14.3 32-32V320c0-65.2-48.8-119-111.8-127zM434.7 368a48 48 0 1 1 90.5 32 48 48 0 1 1 -90.5-32zM160 336a48 48 0 1 1 0 96 48 48 0 1 1 0-96z"/>"}}},{"matchers":["ship","sailing","cruise"],"theme":{"color":"var(--bs-orange)","dashArray":"4 8","svgIcon":{"viewBox":"0 0 576 512","items":"<path d=\"M256 16c0-7 4.5-13.2 11.2-15.3s13.9 .4 17.9 6.1l224 320c3.4 4.9 3.8 11.3 1.1 16.6s-8.2 8.6-14.2 8.6H272c-8.8 0-16-7.2-16-16V16zM212.1 96.5c7 1.9 11.9 8.2 11.9 15.5V336c0 8.8-7.2 16-16 16H80c-5.7 0-11-3-13.8-8s-2.9-11-.1-16l128-224c3.6-6.3 11-9.4 18-7.5zM5.7 404.3C2.8 394.1 10.5 384 21.1 384H554.9c10.6 0 18.3 10.1 15.4 20.3l-4 14.3C550.7 473.9 500.4 512 443 512H133C75.6 512 25.3 473.9 9.7 418.7l-4-14.3z"/>"}}}]},{"name":"Sport","matchers":[{"matchers":["(\\b|_|-)run"],"theme":{"color":"var(--bs-primary)","dashArray":"","svgIcon":{"viewBox":"0 0 417 512","items":"<path d=\"M320 48a48 48 0 1 0 -96 0 48 48 0 1 0 96 0zM125.7 175.5c9.9-9.9 23.4-15.5 37.5-15.5c1.9 0 3.8 .1 5.6 .3L137.6 254c-9.3 28 1.7 58.8 26.8 74.5l86.2 53.9-25.4 88.8c-4.9 17 5 34.7 22 39.6s34.7-5 39.6-22l28.7-100.4c5.9-20.6-2.6-42.6-20.7-53.9L238 299l30.9-82.4 5.1 12.3C289 264.7 323.9 288 362.7 288H384c17.7 0 32-14.3 32-32s-14.3-32-32-32H362.7c-12.9 0-24.6-7.8-29.5-19.7l-6.3-15c-14.6-35.1-44.1-61.9-80.5-73.1l-48.7-15c-11.1-3.4-22.7-5.2-34.4-5.2c-31 0-60.8 12.3-82.7 34.3L57.4 153.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l23.1-23.1zM91.2 352H32c-17.7 0-32 14.3-32 32s14.3 32 32 32h69.6c19 0 36.2-11.2 43.9-28.5L157 361.6l-9.5-6c-17.5-10.9-30.5-26.8-37.9-44.9L91.2 352z"/>"}}},{"matchers":["(\\b|_|-)walk"],"theme":{"color":"var(--bs-primary)","dashArray":"","svgIcon":{"viewBox":"0 0 320 512","items":"<path d=\"M160 48a48 48 0 1 1 96 0 48 48 0 1 1 -96 0zM126.5 199.3c-1 .4-1.9 .8-2.9 1.2l-8 3.5c-16.4 7.3-29 21.2-34.7 38.2l-2.6 7.8c-5.6 16.8-23.7 25.8-40.5 20.2s-25.8-23.7-20.2-40.5l2.6-7.8c11.4-34.1 36.6-61.9 69.4-76.5l8-3.5c20.8-9.2 43.3-14 66.1-14c44.6 0 84.8 26.8 101.9 67.9L281 232.7l21.4 10.7c15.8 7.9 22.2 27.1 14.3 42.9s-27.1 22.2-42.9 14.3L247 287.3c-10.3-5.2-18.4-13.8-22.8-24.5l-9.6-23-19.3 65.5 49.5 54c5.4 5.9 9.2 13 11.2 20.8l23 92.1c4.3 17.1-6.1 34.5-23.3 38.8s-34.5-6.1-38.8-23.3l-22-88.1-70.7-77.1c-14.8-16.1-20.3-38.6-14.7-59.7l16.9-63.5zM68.7 398l25-62.4c2.1 3 4.5 5.8 7 8.6l40.7 44.4-14.5 36.2c-2.4 6-6 11.5-10.6 16.1L54.6 502.6c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L68.7 398z"/>"}}},{"matchers":["(\\b|_|-)hike","(\\b|_|-)hiking"],"theme":{"color":"var(--bs-primary)","dashArray":"","svgIcon":{"viewBox":"0 0 384 512","items":"<path d=\"M192 48a48 48 0 1 1 96 0 48 48 0 1 1 -96 0zm51.3 182.7L224.2 307l49.7 49.7c9 9 14.1 21.2 14.1 33.9V480c0 17.7-14.3 32-32 32s-32-14.3-32-32V397.3l-73.9-73.9c-15.8-15.8-22.2-38.6-16.9-60.3l20.4-84c8.3-34.1 42.7-54.9 76.7-46.4c19 4.8 35.6 16.4 46.4 32.7L305.1 208H336V184c0-13.3 10.7-24 24-24s24 10.7 24 24v55.8c0 .1 0 .2 0 .2s0 .2 0 .2V488c0 13.3-10.7 24-24 24s-24-10.7-24-24V272H296.6c-16 0-31-8-39.9-21.4l-13.3-20zM81.1 471.9L117.3 334c3 4.2 6.4 8.2 10.1 11.9l41.9 41.9L142.9 488.1c-4.5 17.1-22 27.3-39.1 22.8s-27.3-22-22.8-39.1zm55.5-346L101.4 266.5c-3 12.1-14.9 19.9-27.2 17.9l-47.9-8c-14-2.3-22.9-16.3-19.2-30L31.9 155c9.5-34.8 41.1-59 77.2-59h4.2c15.6 0 27.1 14.7 23.3 29.8z"/>"}}},{"matchers":["(\\b|_|-)bike","(\\b|_|-)biking","(\\b|_|-)cycling"],"theme":{"color":"var(--bs-primary)","dashArray":"","svgIcon":{"viewBox":"0 0 640 512","items":"<path d=\"M400 96a48 48 0 1 0 0-96 48 48 0 1 0 0 96zm27.2 64l-61.8-48.8c-17.3-13.6-41.7-13.8-59.1-.3l-83.1 64.2c-30.7 23.8-28.5 70.8 4.3 91.6L288 305.1V416c0 17.7 14.3 32 32 32s32-14.3 32-32V288c0-10.7-5.3-20.7-14.2-26.6L295 232.9l60.3-48.5L396 217c5.7 4.5 12.7 7 20 7h64c17.7 0 32-14.3 32-32s-14.3-32-32-32H427.2zM56 384a72 72 0 1 1 144 0A72"/>"}}}]}]
```

--------------------------------

### Directory Structure for Photos

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/blog/How do I use PiGallery2 2021.md

This example shows a recommended directory structure for organizing photos before they are added to PiGallery2. It includes a hierarchical organization by year and event.

```text
|-- Family
  |-- 2000
  |-- 2001
  |--2002
    |--2002.01.01 Event name 1
    |--2002.04.01 Event name 2
    |--2002.05.01-10 A long event
|-- Other
  |-- 2000
    |-- 2000.05.02 Some event name
```

--------------------------------

### Set Configuration via Environment Variable

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Example of how to set a configuration value, such as 'MyConf', using an environment variable. This is specific to Windows SET command.

```bash
SET MyConf=5
```

--------------------------------

### Start Docker Compose Services

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

Starts the Docker containers defined in the docker-compose.yml file in detached mode. The '-d' flag runs the containers in the background.

```bash
docker-compose up -d
```

--------------------------------

### Install Docker Compose Dependencies

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

Installs necessary dependencies for Docker Compose on Debian-based systems. This includes libraries for SSL and FFI, along with Python 3 and pip.

```bash
sudo apt-get install libffi-dev libssl-dev
sudo apt-get install -y python3 python3-pip
sudo apt-remove python-configparser
```

--------------------------------

### Server URL Base Configuration

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Specifies the base URL if the gallery is accessed under a sub-path (e.g., https://mydomain.com/myGallery). Ensure the URL starts with a '/' if needed.

```bash
--Server-urlBase
```

--------------------------------

### Example Job Configuration

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

This snippet shows a configuration for a scheduled job within Pigallery 2. It includes job details, configuration parameters, and trigger conditions.

```json
{
    "name": "Album Cover Filling",
    "jobName": "Album Cover Filling",
    "config": {},
    "allowParallelRun": false,
    "trigger": {
        "type": "after",
        "periodicity": 7,
        "atTime": 0,
        "afterScheduleName": "Indexing"
    }
}
```

```json
{
    "name": "Photo Converting",
    "jobName": "Photo Converting",
    "config": {
        "sizes": [
            320
        ],
        "maxVideoSize": 800,
        "indexedOnly": true
    },
    "allowParallelRun": false,
    "trigger": {
        "type": "after",
        "periodicity": 7,
        "atTime": 0,
        "afterScheduleName": "Album Cover Filling"
    }
}
```

```json
{
    "name": "Video Converting",
    "jobName": "Video Converting",
    "config": {
        "indexedOnly": true
    },
    "allowParallelRun": false,
    "trigger": {
        "type": "after",
        "periodicity": 7,
        "atTime": 0,
        "afterScheduleName": "Photo Converting"
    }
}
```

```json
{
    "name": "GPX Compression",
    "jobName": "GPX Compression",
    "config": {
        "indexedOnly": true
    },
    "allowParallelRun": false,
    "trigger": {
        "type": "after",
        "periodicity": 7,
        "atTime": 0,
        "afterScheduleName": "Video Converting"
    }
}
```

```json
{
    "name": "Temp Folder Cleaning",
    "jobName": "Temp Folder Cleaning",
    "config": {
        "indexedOnly": true
    },
    "allowParallelRun": false,
    "trigger": {
        "type": "after",
        "periodicity": 7,
        "atTime": 0,
        "afterScheduleName": "GPX Compression"
    }
}
```

--------------------------------

### Run PiGallery2 with Port Override

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/direct-install.md

Starts the PiGallery2 application and overrides the default server port using a command-line switch. This is useful for quick configuration changes.

```bash
npm start -- --Server-port=8080
```

--------------------------------

### Display Help and Options

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Run this command to display all available meta CLI options and application CLI options for Pigallery 2.

```bash
npm start -- --help
```

--------------------------------

### Build Client (Development)

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/contributing.md

Builds the client with English localization and watches for source file changes. This command runs continuously.

```bash
npm run run-dev
```

--------------------------------

### Create Configuration Directory

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/blog/[Tutorial] Pigallery2 From Zero To Hero 2025.md

Create a central directory to store all service configuration files for easy backup and management.

```bash
cd ~
mkdir config
```

--------------------------------

### Sample config.json for PiGallery 2

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

This JSON snippet shows a sample configuration file for PiGallery 2, illustrating various server settings like application title, public URL, API path, and custom HTML head content.

```json
{
    "Server": {
        "applicationTitle": "PiGallery 2",
        "//[publicUrl]": "If you access the page from local network it's good to know the public url for creating sharing link.",
        "publicUrl": "",
        "//[urlBase]": "If you access the gallery under a sub url (like: https://mydomain.com/myGallery), set it here. If it is not working you might miss the '/' from the beginning of the url.",
        "urlBase": "",
        "//[apiPath]": "PiGallery api path.",
        "apiPath": "/pgapi",
        "//[customHTMLHead]": "Injects the content of this between the <head></head> HTML tags of the app. (You can use it to add analytics or custom code to the app).",
        "customHTMLHead": "",
        "//[svgIcon]": "Sets the icon of the app. Rendered icons are cached in the tmp folder.",
        "svgIcon": {
            "//[viewBox]": "SVG path viewBox. See: https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/viewBox",
            "viewBox": "0 0 512 512",
            "//[items]": "Content elements (paths, circles, rects) of the SVG icon. Icons used on the map: fontawesome.com/icons."

```

--------------------------------

### Configure Photo Settings

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Set the icon size for maps and the thumbnail size for person faces.

```json
{
    "//[iconSize]": "Icon size (used on maps).",
    "iconSize": 45,
    "//[personThumbnailSize]": "Person (face) thumbnail size.",
    "personThumbnailSize": 200
}
```

--------------------------------

### Obtain SSL Certificate with Certbot

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

Obtains a standalone SSL certificate for a domain using Certbot. This command is used to secure your PiGallery2 installation with HTTPS.

```bash
certbot certonly --standalone -d yourdomain.com
```

--------------------------------

### Enable Themes and Color Modes

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Enable themes and color modes for the application. Sets the default theme mode.

```json
{
    "//[enabled]": "Enable themes and color modes.",
    "enabled": true,
    "//[defaultMode]": "Sets the default theme mode that is used for the application.",
    "defaultMode": "auto",
    "//[selectedTheme]": "Selected theme to use on the site.",
    "selectedTheme": "classic"
}
```

--------------------------------

### Run a Specific Test File

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/contributing.md

Execute a specific test file, such as the SettingsRouter integration tests in the backend.

```bash
npx mocha ./test/backend/integration/routers/admin/SettingsRouter.js
```

--------------------------------

### Portainer Docker Compose Configuration

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/blog/[Tutorial] Pigallery2 From Zero To Hero 2025.md

Defines the Docker Compose setup for running the Portainer CE container, including volume mounts for persistent data and Docker socket access.

```yaml
version: "3.9"
services:
  homer:
    image: portainer/portainer-ce:lts
    container_name: portainer
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    ports:
      - 9443:9443
    restart: always

volumes:
  portainer_data:
    external: true
```

--------------------------------

### Nginx Configuration for PiGallery2 Access

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/advanced/advanced-docker-npm-portainer.md

This Nginx configuration restricts access to the PiGallery2 service to only GET requests for security purposes, while allowing other HTTP versions for proxying. It sets up the necessary headers for WebSocket upgrades.

```nginx
location / {
    limit_except GET {
        deny all;
    }
    proxy_pass http://pigallery2:80;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}
```

--------------------------------

### Download Release Artifact

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/docker-contributing.md

Download the latest release zip file for building the Docker image.

```bash
wget https://github.com/bpatrik/pigallery2/releases/download/3.1.0/pigallery2-release.zip
unzip pigallery2-release.zip -d pigallery2
cd pigallery2
```

--------------------------------

### Build Backend

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/contributing.md

Transpiles TypeScript files to JavaScript for Node.js execution.

```bash
npm run build-backend
```

--------------------------------

### Build Docker Image Locally

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/development/docker-contributing.md

Build the PiGallery2 Docker image locally using the downloaded release files. This command uses plain progress output.

```bash
$ sudo docker build --progress=plain   -t local-pg .
```

--------------------------------

### Configure Inline and Top Blog Settings

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Control whether inline and top blog content automatically opens. These settings affect how blog posts are displayed by default.

```json
{
    "//[InlineBlogStartsOpen]": "Makes inline blog (*.md files content) auto-open.",
    "InlineBlogStartsOpen": false,
    "//[TopBlogStartsOpen]": "Makes top blog (*.md files content) auto-open.",
    "TopBlogStartsOpen": false
}
```

--------------------------------

### Match Types for Searching

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/features.md

Demonstrates different match types for searching photos, including exact, wildcard, and negation matches.

```bash
person:"John" # exact match
person:(John) # wildcard match
person:John # same as person:(John)
person!:John # negation
```

--------------------------------

### Configure Sorting and Grouping Methods

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Set the default sorting and grouping methods for photos and videos, both in directory listings and search results. This includes specifying the sorting/grouping criteria and order (ascending/descending).

```json
{
    "SortingGrouping": {
        "//[defaultPhotoSortingMethod]": "Default sorting method for photo and video in a directory results.",
        "defaultPhotoSortingMethod": {
            "method": "Date",
            "ascending": true
        },
        "//[defaultSearchSortingMethod]": "Default sorting method for photo and video in a search results.",
        "defaultSearchSortingMethod": {
            "method": "Date",
            "ascending": false
        },
        "//[defaultPhotoGroupingMethod]": "Default grouping method for photo and video in a directory results.",
        "defaultPhotoGroupingMethod": {
            "method": "Date",
            "ascending": true
        },
        "//[defaultSearchGroupingMethod]": "Default grouping method for photo and video in a search results.",
        "defaultSearchGroupingMethod": {
            "method": "Date",
            "ascending": false
        }
    }
}
```

--------------------------------

### Override Default Configuration via CLI

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Demonstrates how to override a default configuration value, like 'MyConf', using the 'default-' prefix in the CLI command.

```bash
<appname> --default-MyConf=5
```

--------------------------------

### Run PiGallery2 Docker Container (Before v1.7.0)

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/setup/docker.md

This command is for running versions of PiGallery2 prior to v1.7.0. It requires specific paths for the config file and database, and uses an older image tag. Ensure the config file and database files exist before running.

```bash
docker run \
   -p 80:80 \
   -e NODE_ENV=production \
   -v <path to your config file folder>/config.json:/pigallery2-release/config.json \
   -v <path to your db file folder>/sqlite.db:/pigallery2-release/sqlite.db \
   -v <path to your images folder>:/pigallery2-release/demo/images \
   -v <path to your temp folder>:/pigallery2-release/demo/TEMP \
   bpatrik/pigallery2:1.7.0-stretch
```

--------------------------------

### Boolean Expressions for Searching

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/features.md

Shows how to construct boolean expressions for complex photo searches using AND, OR, and N-of logic.

```text
John and Kate # photos with "John" and "Kate" (any string match)
John Kate # same as "John and Kate"
John or Kate # photos with "John" or "Kate" (any string match)
2-of:(John, Kate, Steve) # lists photos that satisfy at least 2 out of the 3 names
```

--------------------------------

### Configure Auto Update Settings

Source: https://github.com/bpatrik/pigallery2/blob/master/docs/user-guide/configuration.md

Enable and configure automatic polling for new photos and videos. Set the interval for checking updates.

```json
{
    "//[AutoUpdate]": "makes the gallery poll the backend for new photos in the given directory or search",
    "AutoUpdate": {
        "//[enable]": "Enable auto polling for new photos and videos in the gallery.",
        "enable": false,
        "//[interval]": "Frequency of the auto polling in seconds.",
        "interval": 60
    }
}
```