mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-03-11 09:04:54 +00:00
f0f2d21562
- use markdown more explicitly - update information on i18n and translation - move or delete redundant info from HACKING into CONTRIBUTING Signed-off-by: Johannes Keyser <johanneskeyser@posteo.de> Reviewed-by: Sunil Mohan Adapa <sunil@medhas.org>
91 lines
1.6 KiB
Markdown
91 lines
1.6 KiB
Markdown
# 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
|
|
```
|