File: INSTALL.md

package info (click to toggle)
freedombox 26.2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 82,976 kB
  • sloc: python: 48,504; javascript: 1,736; xml: 481; makefile: 290; sh: 167; php: 32
file content (41 lines) | stat: -rw-r--r-- 1,222 bytes parent folder | download | duplicates (4)
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
# Installing FreedomBox Service (Plinth)

The following instructions are for installing FreedomBox from source code meant
for advanced users. For regular use of FreedomBox, instructions are available on
FreedomBox [Manual](https://wiki.debian.org/FreedomBox/Manual/)'s
[QuickStart](https://wiki.debian.org/FreedomBox/Manual/QuickStart) page.

1. Install FreedomBox Service (Plinth):

    A Debian based system is needed to run FreedomBox. Buster release or later
    is recommended. Unzip the source into a directory. Change to the directory
    containing the program and run:

    ```
    $ sudo apt build-dep .
    ```

    ```
    $ sudo apt install -y $(./run --develop --list-dependencies)
    ```

    Install additional dependencies by picking the list from debian/control file
    fields Depends: and Recommends: for the package ''freedombox''. After that
    install FreedomBox Service (Plinth) itself.

    ```
    $ sudo make build install
    ```

2.  Run FreedomBox Service (Plinth):

    ```
    $ sudo plinth
    ```

3.  Access FreedomBox UI:

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

If you are installing FreedomBox Service (Plinth) for development purposes, see
HACKING.md instead.