FreedomBox/INSTALL
Joseph Nuthalpati 62f26433e8
Add django-simple-captcha in the login page
User will be shown captcha in the second attempt to login if login
fails in the first attempt.

Signed-off-by: Joseph Nuthalpati <njoseph@thoughtworks.com>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
2017-10-17 22:07:12 -04:00

75 lines
1.5 KiB
Plaintext

# 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-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
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 \
--upgrade