Differences between revisions 23 and 24
Revision 23 as of 2016-05-24 14:04:45
Size: 2097
Comment: simplify page, remove legend and completed tasks
Revision 24 as of 2017-10-07 19:28:40
Size: 2241
Comment: Added sentence what the motivation is.
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Here 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: Plinth should never edit conffiles (files installed by dpkg) directly, because this will prevent automatic upgrades via UnattendedUpgrades.
Instead, the goal is to do all of this configuration through [[debconf]]. For that, we will need to convince package maintainers to [[http://www.fifi.org/doc/debconf-doc/tutorial.html|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.

NB! Debconf is preferred over alternative methods like .d or multilevel support: Only debconf keeps the maintenance task of tracking intimate configuration details most possible at the package maintainer.

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:
Line 7: Line 12:

The goal is to do all of this configuration through [[debconf]] instead. For that, we will need to convince package maintainers to [[http://www.fifi.org/doc/debconf-doc/tutorial.html|add debconf support]] to their packages, and to add the hooks that we need. This can be done by filing wishlist bug reports against those packages. Offering a patch should improve our chances of success.

NB! Debconf is preferred over alternative methods like .d or multilevel support: Only debconf keeps the maintenance task of tracking intimate configuration details most possible at the package maintainer.

Debconf Configuration Worksheet

Plinth should never edit conffiles (files installed by dpkg) directly, because this will prevent automatic upgrades via UnattendedUpgrades. Instead, the goal is to do all of this 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.

NB! Debconf is preferred over alternative methods like .d or multilevel support: Only debconf keeps the maintenance task of tracking intimate configuration details most possible at the package maintainer.

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

xmpp (no)

yes

auth_method, ldap_servers, ldap_base, (possibly ldap_filter)

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 - Matrix - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Saturday, April 13 at 14: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