mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
80498919fb
- This is completely reworked but based on /Developer page in the FreedomBox Manual. - This documentation can be made available as static site on https://docs.freedombox.org and the /Developer page in the FreedomBox Manual can be dropped. Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org> Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
41 lines
1.4 KiB
ReStructuredText
41 lines
1.4 KiB
ReStructuredText
.. SPDX-License-Identifier: CC-BY-SA-4.0
|
|
|
|
Part 6: Setup
|
|
-------------
|
|
|
|
Installing packages required for the app
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
So far, we haven't dealt with installing the packages needed for Transmission to
|
|
work. Nor did we take care of performing the initial configuration for
|
|
Transmission. FreedomBox takes care of installing all the Debian packages
|
|
required for our app to work. All we need to do is specify the list of the
|
|
Debian packages required in the ``setup()`` method that is called during
|
|
installation:
|
|
|
|
.. code-block:: python3
|
|
|
|
managed_packages = ['transmission-daemon']
|
|
|
|
def setup(helper, old_version=None):
|
|
"""Install and configure the module."""
|
|
helper.install(managed_packages)
|
|
|
|
new_configuration = {
|
|
'rpc-whitelist-enabled': False,
|
|
'rpc-authentication-required': False
|
|
}
|
|
helper.call('post', actions.superuser_run, 'transmission',
|
|
['merge-configuration'],
|
|
input=json.dumps(new_configuration).encode())
|
|
|
|
helper.call('post', app.enable)
|
|
|
|
The first time this app's view is accessed, FreedomBox shows an app installation
|
|
page and allows the user to install the app. After the app installation is
|
|
completed, the user is shown the app's configuration page.
|
|
|
|
In case of our app Transmission, first we are installing the Debian packages,
|
|
then performing the first time configuration on the app using the action script
|
|
and finally enabling the app.
|