nik/FreedomBox
1
0
Fork 0
mirror of https://github.com/freedombox/FreedomBox.git synced 2026-01-21 07:55:00 +00:00
Code Issues Packages Projects Releases Wiki Activity
FreedomBox/INSTALL.md
Sunil Mohan Adapa 0af8175fd0
Install dependency packages during install/provisioning 
This will not install all the dependencies of Plinth but will install the
dependencies required for essential modules to setup properly.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: Joseph Nuthalapati <njoseph@thoughtworks.com>
2017-11-03 12:41:11 +05:30

1.6 KiB
Raw Blame History

Installing Plinth

  1. Install the dependencies:

    On a Debian based system, run:

    $ sudo apt-get install
    augeas-tools
    dblatex
    docbook-utils
    gettext
    gir1.2-glib-2.0
    gir1.2-nm-1.0
    ldapscripts
    libjs-bootstrap
    libjs-jquery
    libjs-modernizr
    make
    network-manager
    ppp
    pppoe
    python3
    python3-apt
    python3-augeas
    python3-bootstrapform
    python3-cherrypy3
    python3-configobj
    python3-coverage
    python3-django
    python3-django-axes
    python3-django-captcha
    python3-django-stronghold
    python3-gi
    python3-psutil
    python3-requests
    python3-ruamel.yaml
    python3-setuptools
    xmlto

  2. Install Plinth:

    Unzip the source into a directory. Change to the directory containing the program and run:

    $ sudo python3 setup.py install $ sudo apt install -y $(plinth --list-dependencies)

  3. Run Plinth:

    $ sudo plinth

  4. Access Plinth UI:

    Plinth UI should be accessible at http://localhost:8000/plinth

Note on Django version:

Django 1.11 is required to run Plinth. You can check the version by running:

$ django-admin --version

If apt-get provided django<1.11, then follow the steps below:

  1. Uninstall older django versions:

    $ sudo apt-get remove python3-django python3-django-stronghold
    python3-bootstrap

  2. Install Python3 pip:

    $ sudo apt-get install python3-pip

  3. Install django1.11 through pip:

    $ sudo pip3 install django django-bootstrap-form django-stronghold
    django-axes django-simple-captcha --upgrade