File: INSTALL.md

package info (click to toggle)
plinth 19.1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 28,292 kB
  • sloc: python: 22,057; xml: 12,007; sh: 568; pascal: 74; makefile: 49; php: 11
file content (93 lines) | stat: -rw-r--r-- 1,855 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# Installing FreedomBox Service (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 FreedomBox Service (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 FreedomBox Service (Plinth):

    ```
    $ sudo plinth
    ```

4.  Access FreedomBox UI:

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

# Note on Django version:

Django 1.11 is required to run FreedomBox Service (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
    ```