Etherbox : Différence entre versions

De erg

(Set up etherpad)
(Set up etherpad)
Ligne 192 : Ligne 192 :
<pre>systemctl enable etherpad-lite</pre>
<pre>systemctl enable etherpad-lite</pre>
les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
= etherdump =
= etherdump =

Version du 30 janvier 2018 à 11:53

These notes are based on a setup used by the "SOftware observatory" workshop, Constant Michael Murtaugh (discussion) 30 janvier 2018 à 10:48 (CET)

Initial image + setup

Downloaded from

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on

unzip -p | pv | sudo dd of=/dev/sdc bs=4M

You could use as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

sudo raspi-config

Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

sudo apt-get update
sudo apt-get upgrade

How to find the IP address of the pi

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

   ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

   ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

Make it easier to login, with an ssh key

Starting from your laptop (open a new Terminal session if you are connected to the pi):


Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

   ssh-copy-id pi@raspberrypi.local

Setup apache to serve the root with custom header + readme's

sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf
    ServerAdmin webmaster@localhost
    # DocumentRoot /var/www/html
    DocumentRoot /home/pi
    <Directory /home/pi>
           Options Indexes FollowSymLinks
           AllowOverride none
           Require all granted

    HeaderName /include/HEADER.shtml
    ReadmeName README.html

NB: Sets the HeaderName and ReadmeName directives (part of mod_autoindex).

sudo service apache2 reload


sudo a2enmod cgi
sudo service apache2 restart

Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:


Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

  sudo chmod +x droptoupload.cgi


Sample Header that adds javascript to:

<script src="/cgi-bin/droptoupload.cgi"></script>
body {
background: #38b8e9;
color: black;
a {
color: white;
#logo {
white-space: pre;
font-family: monospace;
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
<a href="">constant</a>
<a href="">gitlab</a>
.links {
font-family: monospace;
text-transform: uppercase;
document.addEventListener("DOMContentLoaded", function () {
  var p = document.querySelectorAll(".top"),
      t = document.getElementsByTagName("table")[0];
  for (var i=0, l=p.length; i<l; i++) {
    document.body.insertBefore(p[i], t);

Better permissions with facl


sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi

Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

sudo chmod g-w /home/pi

Set up etherpad

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad

Used password VJ.

Create your setting file.

sudo cp settings.json.template settings.json

Run etherpad for the first time as the etherpad user...

cd /opt/etherpad
sudo --user etherpad bin/

Following the first recipe on this page about deploying etherpad as a systemd service

sudo nano /etc/systemd/system/etherpad.service
Description=Etherpad-lite, the collaborative editor.

ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js


After this,

sudo service etherpad start

Seems to work! Apparently it's the same as:

systemctl start etherpad-lite

And to start on boot:

systemctl enable etherpad-lite

les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.


System wide installation of etherdump

Install deps:

sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib

Install from repo:

git clone
cd etherdump
sudo python install

Setup the folder

cd /home/pi
mkdir etherdump
cd etherdump
etherdump init

Type in:


And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

styles.css + versions.js

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match. + cron

Make the script that runs automatically.

# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html

And set it to run every 5 minutes

crontab -e
# m h  dom mon dow   command
*/5 * * * * /home/pi/ > /home/pi/cron.log.txt 2>&1

The PATH is important. It can also be in the but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

Other software

sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit

To install

  • screen
  • pandoc + latex
  • pdftk
  • csvkit

What about

  • texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)


sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended 

Was able to:

pandoc --from markdown hello.markdown -o hello.pdf

Access point

Taken from this "ultimate" guide

apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip 
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac

Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

auto eth0
allow-hotplug eth0
iface etho inet dhcp

# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
#    wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static

Replace /etc/dnsmasq.conf with:


Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)


Edit /etc/default/hostapd and add


Make hostapd start at boot

update-rc.d hostapd defaults


Makeserver + etherpad (experimental!)


  • Etherdump's pad.html with <rel> links including LIVE EDIT URLs
  • THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...


cd /home/pi/software
git clone
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2

BUGFIX with twisted / SSL issues:

sudo pip install twisted[tls]

DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!


  • Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?


Changed dnsmasq.conf

#address=/#/                                                                                                           # no-resolv

AND added to /etc/hosts etherbox.local

and this seems to then work over the direct hotspot connection.