billznn/opodsync_dckr repository overview

⁠References

Source: https://github.com/mzannoni/opodsync_dckr⁠

Original project: https://github.com/kd2org/opodsync⁠

⁠Quick start

⁠1. Create the data directory and config file

Create a data/ directory and place a config.local.php file inside it. You can use the example config from the source repo⁠ as a starting point.

At minimum, set TITLE and BASE_URL in the config file.

Then fix ownership so the container can write to it:

sudo chown 33:33 data

⁠2. Create a docker-compose.yml

services:
  opodsync:
    image: billznn/opodsync_dckr:latest
    container_name: opodsync
    restart: unless-stopped
    volumes:
      - ./data:/var/www/html/data
    user: "33:33"
    ports:
      - "8765:80"

⁠3. Run

docker compose up -d

The server will be available at http://localhost:8765.

⁠Usage with Pangolin (on the same host)

If you're using Pangolin⁠ as a reverse proxy running as a Docker container on the same machine, the two need to share a Docker network.

services:
  opodsync:
    image: billznn/opodsync_dckr:latest
    container_name: opodsync
    restart: unless-stopped
    volumes:
      - ./data:/var/www/html/data
    user: "33:33"
    ports:
      - "8765:80"
    networks:
      - pangolin

networks:
  pangolin:
    external: true

The pangolin external network is created and managed by Pangolin's own Docker Compose setup.
Create a resource in Pangolin located in a local site, with target address https://opodsync and port 80.

⁠Running as a systemd service

To manage this container with systemd (including proper dependency ordering when running alongside Pangolin), see the service unit file and instructions in servarious⁠.

⁠Configuration

See the full configuration reference in the oPodSync documentation⁠.