Differences between revisions 10 and 11
Revision 10 as of 2015-09-01 15:33:59
Size: 2750
Editor: ?DanielGnoutcheff
Comment: /etc/network/interfaces issue
Revision 11 as of 2015-09-13 15:15:18
Size: 2786
Comment: Modify structure for inclusion into manual
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Debian ==
Line 13: Line 15:

== Installing on Debian ==
=== Installing on Debian ===
Line 48: Line 49:
== Troubleshooting == === Troubleshooting ===
Line 65: Line 66:
## END_INCLUDE

Debian

debian.png

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 currently runs Debian Unstable (Sid) and Debian Testing (Strech).

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.

Installing on Debian

  1. Install Debian Unstable (Sid) on your hardware.

    • If you choose to create an initial user account, use "fbx" as the login name. (Once the FreedomBox setup program completes, all user accounts except for the "fbx" account will be locked out via pam_access. This also affects sudo access.)

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

    $ sudo apt-get install freedombox-setup
  4. Run FreedomBox setup program. This installs further packages and sets up basic configuration.

    $ sudo /usr/lib/freedombox/setup | tee freedombox-setup.log
  5. Reboot the system. This is necessary to trigger the first-run script.
    $ sudo reboot
  6. After the system boots up, wait for it to reboot again. The first-run scripts sets up a few things and initiates a reboot.
  7. After the second reboot you can start ?using FreedomBox.

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 may misbehave if any non-loopback interfaces are 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


Intro

Information

Support

Contribute

Reports

Promote

Vision

Hardware

Live Help

Where To Start

Translate

Calls

Talks

Overview

Download

Q&A

To Do

Design

Releases

Press

Features

Manual

Contributors

Code

Blog

FreedomBox for Communities

FreedomBox Developer Manual

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

Next call: Saturday, April 13 at 14:00 UTC

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


CategoryFreedomBox

See the Debian logo page for information on its copyright.