Differences between revisions 27 and 28
Revision 27 as of 2016-08-13 16:24:06
Size: 3629
Comment: remove warning to use "fbx" username, no longer required
Revision 28 as of 2017-01-16 12:30:26
Size: 3660
Comment: add flag to avoid prompts
Deletions are marked like this. Additions are marked like this.
Line 36: Line 36:
$ sudo apt-get install freedombox-setup $ sudo DEBIAN_FRONTEND=noninteractive apt-get install freedombox-setup

Translation(s): Deutsch - English


FreedomBox is a pure blend of Debian. This means that all the work on FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a FreedomBox.

This page describes the process of installing FreedomBox on a Debian system. Currently, FreedomBox works in Debian Testing (Stretch) and Unstable (Sid).

Use a fresh Debian installation

Installing FreedomBox changes your Debian system in many important ways. This includes installing a firewall and regenerating server certificates. It is hence recommended that you install FreedomBox on a fresh Debian installation instead of an existing setup.

1. Installing on Debian

  1. Check the Troubleshooting section below, for any tips or work-arounds that might help during the install.
  2. Install Debian Testing (Stretch) or Unstable (Sid) on your hardware.

  3. Update your package list.
    $ sudo apt-get update
  4. Install freedombox-setup package.

    $ sudo DEBIAN_FRONTEND=noninteractive apt-get install freedombox-setup
    • When asked to specify whether Macchanger should be set up to run automatically, please choose "No".
  5. Run FreedomBox setup program. This installs further packages and sets up basic configuration.

    $ sudo /usr/lib/freedombox/setup | tee freedombox-setup.log
    You may have to clear your existing network configuration. See Troubleshooting note #2 below.
  6. Reboot the system. This is necessary to trigger the first-run script.
    $ sudo reboot
  7. After the system boots up, wait for it to reboot again. The first-run scripts sets up a few things and initiates a reboot.
  8. After the second reboot you can start ?using FreedomBox.

2. Troubleshooting

  1. There is a bug in policykit-1 package that causes errors and hangs during installation of freedombox-setup package. A workaround is to first install policykit-1 package and then reboot. After that, follow the above procedure setup procedure.

    $ sudo apt-get update
    $ sudo apt-get install policykit-1
    $ sudo reboot
  2. Freedombox does not support network device configuration via /etc/network/interfaces, and it will not manage any non-loopback interfaces mentioned there. (See bug #797614.) Future versions of freedombox-setup will clear this file automatically; for now, edit it manually and ensure that it contains only the following:

    auto lo
    iface lo inet loopback

    If you have already completed the setup process without doing this step, you will need to clear out the /etc/network/interfaces file keeping only the above lines. Then perform a reboot. After this network connections configured by the setup step above will configure your network. Network interfaces will then be in the internal or external firewall zone. This is essential for the FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the nmtui command if you wish.








Live Help

Where To Start








To Do








FreedomBox for Communities

FreedomBox Developer Manual

HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Sunday, October 25th at 17:00 UTC

Latest news: Help translate freedombox.org - 2020-08-01

This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.


See the Debian logo page for information on its copyright.