FreedomBox/INSTALL
Sunil Mohan Adapa 7a9a4cd861
packages: Switch to installing with apt-get
- Use action helper so that Plinth can run unprivilaged and action
  script can run as root.

- Use Status-Fd feature of apt-get to report progress.  Don't report
  much detail.

- Capture all stderr of the apt-get process and present it only in case
  of failure.

- Remove package installation using PackageKit.  Remove dependency on
  PackageKit.

- Merge --setup package installation with regular package installation.

This should fix the following problems:

- PackageKit throws errors when APT encounters an error and later
  corrects them and proceeds well.  This is reported upstream but not
  fixed.

- PackageKit does not install recommends by default and there is no easy
  way to tell it to do so.

- In some rare cases, PackageKit could get stuck for interactive input
  even though interactive flag is set to false.

- PackageKit does not work without network manager connections. (Could
  have been mitigated by altering packagekit configuration).

- PackageKit glib library leaks file descriptors after each operation.
  This leads to running out of fds during long running refresh
  operations such as OpenVPN setup.  (This should have subsided by not
  checking package install with the new setup mechanism.)]

Known issues:

- In development mode, inside action scripts the python modules are
  always loaded from system path and not development directory.

- With PackageKit it is possible to run multiple operations
  simultaneously.  Others would wait while the first is being
  installed.  With new implementation, the others error out unable to
  obtain lock.
2016-06-11 12:11:40 -04:00

49 lines
907 B
Plaintext

# Installing Plinth
1. Install the dependencies:
On a Debian based system, run:
$ sudo apt-get install \
augeas-tools \
dblatex \
gettext \
gir1.2-glib-2.0 \
gir1.2-networkmanager-1.0 \
ldapscripts \
libjs-bootstrap \
libjs-jquery \
libjs-modernizr \
make \
network-manager \
ppp \
pppoe \
python3 \
python3-augeas \
python3-bootstrapform \
python3-cherrypy3 \
python3-coverage \
python3-django \
python3-django-stronghold \
python3-gi \
python3-psutil \
python3-requests \
python3-setuptools \
python3-yaml \
xmlto
2. Install Plinth:
Unzip the source into a directory. Change to the directory containing the
program and run:
$ sudo python3 setup.py install
3. Run Plinth:
$ sudo plinth
4. Access Plinth UI:
Plinth UI should be accessible at http://localhost:8000