Debconf Configuration Worksheet

FreedomBox should never edit configuration files that are installed by dpkg directly (so-called conffiles), because this will prevent automatic upgrades via UnattendedUpgrades (because overwriting conffiles requires manual confirmation). Instead, the goal is to do all of Plinth's configuration through debconf. For that, we will need to convince package maintainers to add debconf support to their packages, and to add the hooks that we need. This can be done by filing wish-list bug reports against those packages. Offering a patch should improve our chances of success.

Note that debconf is preferred over alternative methods like .d directories or multilevel support: Debconf keeps the maintenance task of tracking intimate configuration details as much as possible at the package maintainer, thus prevents us from duplicating that effort.

Below is a list of configuration files on the FreedomBox which are owned or configured by other packages, and are currently modified by scripts in freedombox-setup or plinth. You can find modified conffiles on your FreedomBox with the following command:

dpkg-query -W -f='${Conffiles}\n' '*' | awk 'OFS="  "{print $2,$1}' | LANG=C md5sum -c 2>/dev/null | awk -F': ' '$2 !~ /OK$/{print $1}' | sort

Table Legend

Package

Plinth Module (Essential?)

Has debconf support?

Modified conffile

Additional hooks needed:

Related bugreports

tor

tor (no)

no

/etc/tor/torrc

SocksPort, ORPort, ControlPort, BridgeRelay, ExitPolicy, ServerTransportPlugin

ejabberd

ejabberd (no)

yes

auth_method, ldap_servers, ldap_base, (possibly ldap_filter)

matrix-synapse

matrixsynapse (no)

?

/etc/matrix-synapse/homeserver.yaml

?

?

ldapscripts

users (yes)

no

/etc/ldapscripts/ldapscripts.conf

SASLAUTH, PASSWORDGEN, SERVER, SUFFIX, USUFFIX, GSUFFIX

libpam-modules

users (yes)

yes

/etc/security/access.conf

Add entry

pagekite

pagekite (no)

no

/etc/pagekite.d/10_account.rc

abort_not_configured, kitename, kitesecret

transmission-daemon

transmission (no)

no

/etc/transmission-daemon/settings.json

download_dir, rpc_username, rpc_password


Information

Support

Work Space

Reports

Promote

Overview

Hardware

Live Help

Where To Start

Translate

Calls

Talks

Features

Vision

Q&A

Design

To Do

Metrics

Press

Download

Manual

Use cases

Code

Contributors

Releases

Blog

HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Alioth Projects, GitHub

Next call: Saturday, November 11th at 14:00 UTC

Latest news: Stable FreedomBox images - 2017-08-05

This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.


CategoryFreedomBox