FreedomBox/INSTALL.md
Vikas Singh 5132f8fff6
theme: Update CSS to use Lato font
Closes #316. Also increase the font size to 15px as this seems roughly
equivalent to 14px size of the earlier font.

Signed-off-by: Vikas Singh <vikas.singh093@gmail.com>
Reviewed-by: Sunil Mohan Adapa <sunil@medhas.org>
2018-02-12 11:44:47 +05:30

93 lines
1.7 KiB
Markdown

# Installing Plinth
1. Install the dependencies:
On a Debian based system, run:
```
$ sudo apt-get install \
augeas-tools \
dblatex \
docbook-utils \
e2fsprogs \
fonts-lato \
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
```