Giter Club home page Giter Club logo

docker-ddclient's Introduction

Project status

CI/CD on master Regular Docker image vulnerability scan

HomeCentr - ddclient

This docker image contains the latest version of the ddclient (the fork on GitHub, not the original SourceForge hosted project) compliant with the HomeCenter docker images standard (S6 overlay, privilege drop etc. The image is as minimal as possible, but contains all Perl dependencies required for ddclient.

Usage

version: "3.7"
services:
  ddclient:
    build: .
    image: homecentr/ddclient
    environment:
      CRON_SCHEDULE: "* * * * *"
      DDCLIENT_ARGS: "-verbose -debug"
    volumes:
      - ./example/ddclient.conf:/config/ddclient.conf

Environment variables

Name Default value Description
PUID 7077 UID of the user ddclient should be running as. The UID must have sufficient rights to read the ddclient.conf file.
PGID 7077 GID of the user ddclient should be running as. The GID must have sufficient rights to read the ddclient.conf file.
CRON_SCHEDULE 30 * * * * (every half hour) Sets how often the ddclient will be executed. You can use Cron expression to create custom schedules if you are not familiar with the cron syntax.
DDCLIENT_ARGS Additional command line arguments passed to the ddclient. Please note, the config path is already passed and that ddclient is NOT running as daemon (and shouldn't be as that would break the cron logic).

When debugging the config (ddclient unfortunately doesn't have much of config validation, so it's trial and error...), use the -verbose -debug command line args to dump the state and HTTP requests to output.

Exposed ports

This container does not expose any ports.

Volumes

Container path Description
/config Configuration directory, should contain the ddclient.conf. Please see the examples in ddclient GitHub repository

Security

The container is regularly scanned for vulnerabilities and updated. Further info can be found in the Security tab.

Container user

The container supports privilege drop. Even though the container starts as root, it will use the permissions only to perform the initial set up. The ddclient process runs as UID/GID provided in the PUID and PGID environment variables.

โš ๏ธ Do not change the container user directly using the user Docker compose property or using the --user argument. This would break the privilege drop logic.

docker-ddclient's People

Contributors

dependabot-preview[bot] avatar dependabot[bot] avatar lholota avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.