readme-vars.yml

---

# project information
project_name: pidgin
project_url: "https://pidgin.im/"
project_logo: "https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/pidgin-logo.png"
project_blurb: "[Pidgin]({{ project_url }}) is a chat program which lets you log into accounts on multiple chat networks simultaneously. This means that you can be chatting with friends on XMPP and sitting in an IRC channel at the same time."
project_lsio_github_repo_url: "https://github.com/linuxserver/docker-{{ project_name }}"
project_blurb_optional_extras_enabled: false
# supported architectures
available_architectures:
  - {arch: "{{ arch_x86_64 }}", tag: "latest"}
  - {arch: "{{ arch_arm64 }}", tag: "arm64v8-latest"}
# development version
development_versions: false
# container parameters
common_param_env_vars_enabled: true
param_container_name: "{{ project_name }}"
param_usage_include_env: true
param_env_vars:
  - {env_var: "TZ", env_value: "Europe/London", desc: "Specify a timezone to use EG Europe/London."}
param_usage_include_vols: true
param_volumes:
  - {vol_path: "/config", vol_host_path: "/path/to/config", desc: "Users home directory in the container, stores local files and settings"}
param_usage_include_ports: true
param_ports:
  - {external_port: "3000", internal_port: "3000", port_desc: "Pidgin desktop gui."}
  - {external_port: "3001", internal_port: "3001", port_desc: "Pidgin desktop gui HTTPS."}
opt_security_opt_param: true
opt_security_opt_param_vars:
  - {run_var: "seccomp=unconfined", compose_var: "seccomp:unconfined", desc: "For Docker Engine only, many modern gui apps need this to function on older hosts as syscalls are unknown to Docker."}
# Kasm blurb settings
kasm_blurb: true
external_http_port: "3000"
external_https_port: "3001"
noto_fonts: "font-noto-cjk"
# application setup block
app_setup_block_enabled: true
app_setup_block: |
  The application can be accessed at:

  * http://yourhost:3000/
  * https://yourhost:3001/

  This Pidgin installation comes with default chat plugins plus a series of third party ones. **Please note that the third party plugins for the most part are not simply plug and play, you will need to reference their documentation and possibly generate oauth tokens along with other workarounds**. Third party plugins are always in a state of constant development do not expect every single native feature to work flawlessly. To ease integration with some third party plugins we include Firefox in this image to allow you to fill out captchas or pre-auth before loading your credentials into the program, simply right click the desktop to launch it.

  * Bonjour- Default XMPP style plugin
  * Discord- Provided by [purple-discord](https://github.com/EionRobb/purple-discord)
  * Facebook- Provided by [purple-facebook](https://github.com/dequis/purple-facebook)
  * Gadu-Gadu- Default libgadu plugin
  * Google Talk- Provided by [purple-hangouts](https://github.com/EionRobb/purple-hangouts)
  * GroupWise- Default GroupWise plugin
  * Hangouts- Provided by [purple-hangouts](https://github.com/EionRobb/purple-hangouts)
  * ICQ (WIM)- Provided by [icyque](https://github.com/EionRobb/icyque)
  * IRC- Default IRC plugin
  * Instagram- Provided by [purple-instagram](https://github.com/EionRobb/purple-instagram)
  * Office Comminicator (SIPE)- Provided by [SIPE Project](https://sipe.sourceforge.io/)
  * Rocket.chat- Provided by [purple-rocketchat](https://github.com/EionRobb/purple-rocketchat)
  * SIMPLE- Default plugin
  * Skype (HTTP)- Provided by [skype4pidgin](https://github.com/EionRobb/skype4pidgin)
  * Slack- Provided by [slack-libpurple](https://github.com/EionRobb/slack-libpurple)
  * Telegram- Provided by [telegram-purple](https://github.com/majn/telegram-purple)
  * XMPP- Default XMPP plugin
  * Zephyr- Default project Athena plugin
# init diagram
init_diagram: |
  "pidgin:latest": {
    docker-mods
    base {
      fix-attr +\nlegacy cont-init
    }
    docker-mods -> base
    legacy-services
    custom services
    init-services -> legacy-services
    init-services -> custom services
    custom services -> legacy-services
    legacy-services -> ci-service-check
    init-migrations -> init-adduser
    init-kasmvnc-end -> init-config
    init-os-end -> init-config
    init-config -> init-config-end
    init-crontab-config -> init-config-end
    init-config -> init-crontab-config
    init-mods-end -> init-custom-files
    base -> init-envfile
    init-os-end -> init-kasmvnc
    init-nginx -> init-kasmvnc-config
    init-video -> init-kasmvnc-end
    base -> init-migrations
    init-config-end -> init-mods
    init-mods-package-install -> init-mods-end
    init-mods -> init-mods-package-install
    init-kasmvnc -> init-nginx
    init-adduser -> init-os-end
    init-envfile -> init-os-end
    init-custom-files -> init-services
    init-kasmvnc-config -> init-video
    init-services -> svc-cron
    svc-cron -> legacy-services
    init-services -> svc-de
    svc-nginx -> svc-de
    svc-de -> legacy-services
    init-services -> svc-docker
    svc-de -> svc-docker
    svc-docker -> legacy-services
    init-services -> svc-kasmvnc
    svc-pulseaudio -> svc-kasmvnc
    svc-kasmvnc -> legacy-services
    init-services -> svc-kclient
    svc-kasmvnc -> svc-kclient
    svc-kclient -> legacy-services
    init-services -> svc-nginx
    svc-kclient -> svc-nginx
    svc-nginx -> legacy-services
    init-services -> svc-pulseaudio
    svc-pulseaudio -> legacy-services
  }
  Base Images: {
    "baseimage-kasmvnc:alpine321" <- "baseimage-alpine:3.21"
  }
  "pidgin:latest" <- Base Images
# changelog
changelogs:
  - {date: "06.12.24:", desc: "Rebase to Alpine 3.21."}
  - {date: "23.05.24:", desc: "Rebase to Alpine 3.20."}
  - {date: "10.02.24:", desc: "Update Readme with new env vars and ingest proper PWA icon."}
  - {date: "17.01.24:", desc: "Switch from Chromium to Firefox."}
  - {date: "02.01.24:", desc: "Rebase to Alpine 3.19."}
  - {date: "13.05.23:", desc: "Rebase to Alpine 3.18."}
  - {date: "18.03.23:", desc: "Rebase to KasmVNC base image."}
  - {date: "21.10.22:", desc: "Rebase to Alpine 3.16, migrate to s6v3."}
  - {date: "15.02.22:", desc: "Add build deps for discord."}
  - {date: "23.12.21:", desc: "Rebase to Alpine 3.15."}
  - {date: "26.09.21:", desc: "Rebase to Alpine 3.14."}
  - {date: "14.05.21:", desc: "Initial release."}