FreedomBox/INSTALL.md
Sunil Mohan Adapa c957427a59
debian: Add e2fsprogs as explicit dependency
- To Build-Depends list as tests depend on it.
- To Depends list as storage action needs it.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
2018-01-15 14:14:00 -05:00

1.7 KiB

Installing Plinth

  1. Install the dependencies:

    On a Debian based system, run:

    $ sudo apt-get install \
    augeas-tools \
    dblatex \
    docbook-utils \
    e2fsprogs \
    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