SYNOPSIS
- plinth [-h, --help] [--server_dir {SERVER_DIR}] [--debug] [--diagnose]
DESCRIPTION
Plinth is a web interface to administer the functions of the FreedomBox. It is extensible and is made of modules. Each module provides a simplified user interface to control the underlying functionality of a specific application of FreedomBox. As FreedomBox can act as a wireless router, it is possible to configure networking from Plinth. Plinth allows configuration of basic system parameters such as time zone, hostname and automatic upgrade settings.
OPTIONS
--server_dir SERVER_DIR
- This the URL fragment under which Plinth will provide its services. By default the value from plinth.config is used. Plinth is shipped with a value of /plinth in /etc/plinth/plinth.config. This means that Plinth will be available as http://localhost:8000/plinth by default. When /etc/plinth/plinth.config is not available, plinth.config from current directory is used. In source directory, this has the default value of /.
--debug
- Enable debug mode. Turn off Django security features. Print extra debug messages. Monitor source files for changes and restart Plinth on modifications. Turn on Django debug mode to show details on error pages. Die if there is an error during module initialization.
--diagnose
- If provided, Plinth loads modules, performs initialization but does start the web server. Instead it runs diagnostic tests on each module and exits.
CONFIGURATION
Plinth reads various configuraiton options from the file /etc/plinth/plinth.config. If this file is not present, then it reads configuration file ./plinth.config from the current directory. This is mainly meant to make Plinth work with configuration from source code directory for debugging purposes.
EXAMPLES
Example 1. Start Plinth with default options
-
$ plinth
Run Plinth as guided by configuration file.
Example 2. Run Plinth for debugging
-
$ plinth --server_dir=/plinth --debug
Enable debug mode and run on terminal. Also override the configuration file value for the URL fragment to start Plinth under and set it to /plinth.
BUGS
See m[blue]Plinth issue trackerm[][1] for a full list of known issues and TODO items.
AUTHOR
Plinth Developers
NOTES
- 1.
-
Plinth issue tracker