nik/FreedomBox
1
0
Fork 0
mirror of https://github.com/freedombox/FreedomBox.git synced 2026-01-21 07:55:00 +00:00
Code Issues Packages Projects Releases Wiki Activity
FreedomBox/INSTALL.md
Sunil Mohan Adapa ea362763cd
INSTALL.md: Simplify installation instructions 
- Remove hard-coded list of dependencies. Maintaining a separate list here add
  development burden. This list keeps getting outdated often.

- Redirect users to QuickStart manual page for regular us.

- Remove instructions for Django < 1.11 because it is now available in buster
  and above.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
2019-03-10 09:54:14 -04:00

1.2 KiB
Raw Blame History

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's 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 --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 python3 setup.py 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.