# Configuration and branding

This project involves functional configuration (which URLs to use)
and visual branding (how to name services)

Upstream project by default targeted Liberty Deckplan Host "librem.one",
optionally reconfiguring/rebranding that at build-time.

The Debian package provides install-time reconfiguration/rebranding,
with same default configuration as upstream
except branding changed to use generic term "Liberty One"
(not the domain-specific "Librem One").

If you want to change configuration and/or branding,
then run this command:

```
sudo dpkg-reconfigure ldh-gui-suite
```


## Site-wide deployment

If you want custom configuration and/or branding applied
e.g. as part of an intranet deployment
then you can [preseed] relevant settings to debian-installer.

[preseed]: <https://www.debian.org/releases/stable/amd64/apb.en.html>

Alternatively, if you want custom settings applied
before the package is installed and regardless of it being purged,
you can create the file `/usr/local/share/one.liberty/deckhost.conf`
containing settings to be sourced by the Bourne shell
(i.e. in same format as files below `/etc/default`),
e.g. like this:

```
DOMAIN="liberty.local"
HUB_NAME="Liberty Local"
```


## Derived distribution

If you use this package as part of a derived distribution
(i.e. not from Debian directly)
and different defaults are more suiteable,
then please suggest that to the developers of your distribution
and also tell them that they need not change this package
but can instead ship a file `/usr/share/one.liberty/deckhost.conf`
with content same as documented for local deployment above.


 -- Jonas Smedegaard <dr@jones.dk>  Wed, 04 Mar 2020 20:23:11 +0100
