galpal

galpal gives you and your clients a quick, easy, and beautiful website to access and download photographs. Has all the features of any professional image hosting software, easy to setup, made specifically for photographers.

Light version too!

Documentation

Full documentation is available at https://github.com/Brandon4466/galpal

What Is galpal?

You've already done the hard work. The photography, the editing, everything. Now you're ready to distribute your photos... But how? This is where galpal steps in! No more hassel of how you're going to get the photos to the client or who you're going to have to explain how to use dropbox to. galpal gives a nice and easy to use interface, complete with password protection, to distribute photos to your clients.

Key Features

• Album password protection
• Download all photos or only selected
• Supports multiple albums
• Easily configurable
• Supports multiple platforms (Linux, Windows, macOS) on many architectures (x86, ARM)
• Container support (Docker, Kubernetes)

Installation

For complete installation instructions, visit our Installation Guide. Guides available for Windows, Linux, Docker, and more.

Linux (One-Click Installer)

Installation Script

wget https://github.com/Brandon4466/galpal/install && bash install

Docker Compose

Create docker-compose.yml and add the following. If you have an existing setup change to fit that.

version: "1.0"

services:
  galpal:
    container_name: galpal
    image: github.com/Brandon4466/galpal/galpal:latest
    restart: unless-stopped
    environment:
      - TZ=${TZ}
    user: 1000:1000
    volumes:
      - ${BASE_DOCKER_DATA_PATH}/galpal/config:/config
    ports:
      - 7474:7474

Then start with:

docker compose up -d

Windows

Download the latest Windows installer from here.

MacOS

One-Click Installer

Also compatible with macOS.

App Installer

Download the latest macOS .dmg from here.

Install with Homebrew

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install galpal

brew install galpal

Run

brew services start galpal

Systemd (Recommended)

On Linux-based systems, it is recommended to run galpal as a sort of service with auto-restarting capabilities, in order to account for potential downtime. The most common way is to do it via systemd. This is setup automatically when using the installation script.

If not using the installation script, you will need to create a service file in /etc/systemd/system/ called galpal.service.

touch /etc/systemd/system/galpal@.service

Then place the following content inside the file (e.g. via nano/vim/ed):

[Unit]
Description=galpal service for %i
After=syslog.target network-online.target

[Service]
Type=simple
User=%i
Group=%i
ExecStart=/usr/bin/galpal --config=/home/%i/.config/galpal/

[Install]
WantedBy=multi-user.target

Start the service. Enable will make it startup on reboot.

systemctl enable -q --now --user galpal@$USER

By default, the configuration is set to listen on 127.0.0.1. While galpal works fine as is exposed to the internet, it is recommended to use a reverse proxy like nginx, caddy or traefik.

If you are not running a reverse proxy change host in the config.toml to 0.0.0.0.

Community

We have a great community on Discord! Connect with other galpal users, get notified of new updates, and ask questions!

License

galpal © 2025 by Brandon Brunson is licensed under CC BY-NC-SA 4.0

• Run: You can run galpal in any noncommercial environment.
• Study and Modify: Access to the source code allows you to study and modify galpal to suit your needs.

Copyright 2025