Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Proposed Front End for Freedom Plug UI
Python Shell Other
branch: master

This branch is 424 commits ahead of jvasile:master

Merge pull request #90 from jvalleroy/fix-templates-dir

Module template dirs are under project directory.
latest commit 250b0100aa
@NickDaly authored
Failed to load latest commit information.
actions Merge: Sunil's firewall branch (follow up commits).
doc Update a comment in makefile about modified help pages path
lib/freedombox/first-run.d Remove firewalld services, since they are part of firewalld now.
modules Indentation updates
setup.d Split apache conf into 2 files, one for HTTP and one for SSL.
share Split apache conf into 2 files, one for HTTP and one for SSL.
static Revert 8fd6c60.
sudoers.d Rewrite plinth to use sudo and action scripts instead of exmachina fo…
templates allow app- and page-specific head and javascript files
tests removed deprecated tests, and made the existing ones run again
themes/default Remove unused JS files
vendor Removed ExMachina from Plinth, it's no longer used.
.gitignore when running plinth with default server_dir '/' some static files and…
.gitmodules Merged with James's upstream.
COPYING Remove unused filedict module
INSTALL Remove wrong dependency on libpython2.7
LICENSES Remove unused filedict module
Makefile Use Django dispatcher instead of CherryPy dispatcher
NOTES integrate exmachina configuration management layer
README Rewrite plinth to use sudo and action scripts instead of exmachina fo… Indentation updates Add a default value for actions_dir Rename the context processor Indentation updates Use json instead of simplejson library to avoid extra depedency Indentation updates Merge pull request #90 from jvalleroy/fix-templates-dir
plinth Merged: tzafrir's install_dir patch. Merge additional changes in fonfon/dev branch
plinth.sample.config made more pep8 compliant; added one more check to verify t… Spelling fix and added some awesome whitespace! Rewrite plinth to use sudo and action scripts instead of exmachina fo… Moved actions/ to tests/. use djangos named URLs and url-reverse instead of manually constructi… removed all manual url prefix handling, we only use djangos url syste… moved firstboot handling to a firstboot middleware


% PLINTH(1) Version 0.1 | Plinth User Manual
% February 2011

# Introduction

## Name

plinth - a web front end for administering every aspect of a Freedom Box.

## Synopsis

## Description

The Freedom Box is a net appliance conceived by Eben Moglen.  It
contains free software and is designed to allow you to interface with
the rest of the net under conditions of protected privacy and data

The Plinth front end is a web interface to administer the functions of
the Freedom Box.  For example, the Freedom Box is a wireless router,
and the front end is where you can adjust its settings.

## Overview

The front end is an extensible web platform for forms and menus.  It
allows authenticated users to fill out forms.  The interface saves the
form data and from them generates configuration files for the various
services running on the box.

The interface is pluggable.  Drop modules into place to add new
capabilities to Plinth and your Freedom Box.  Replace existing modules
to get newer, better shinier functions.  The modules will
automatically integrate into the existing menu system so you can
control all of the box's parts from one central location.

The interface will eventually have a 'basic' and an 'expert' mode.  In
basic mode, much of Plinth's configuration and capability are hidden.
Sane defaults are chosen whenever possible.  In expert mode, you can
get down into the details and configure things the average user never
thinks about.  For example, experts can turn off ntp or switch ntp
servers.  Basic users should never even know those options exist.

## Getting Started

See the INSTALL file for additional details.  Run:

    $ make

Once make finishes, run Plinth on the local system with:

    $ bash
Something went wrong with that request. Please try again.