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. Then boot into it, open a terminal and type the following commands.

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


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.