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


Intro

Information

Support

Contribute

Reports

Promote

Vision

Hardware

Live Help

Where To Start

Translate

Calls

Talks

Overview

Download

Q&A

To Do

Design

Releases

Press

Features

Manual

Contributors

Code

Blog

FreedomBox for Communities

FreedomBox Developer Manual

HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Sunday, September 26 at 17:00 UTC

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