A Self-Hosted Inbox for Large Files Power by Happstack and The Raspberry Pi

Posted on October 23, 2015


How to Collect Files from Family and Friends after a Wedding or a Holiday Trip?

I have found myself repeatedly in a situation where I wanted to collect photos, videos, or some other files from my family and friends: Think wedding, or holiday trip! For this, I see two principal options:

As much as I like the concept of peer-to-peer communications, this option is outright too complicated for many less tech-savvy family members and friends. And even the cloud-based option has a couple of downsides:

Well, there are other solutions! The one I wanted to explore and which I am going to explain in the following is based on a self-hosted solution using a very small and energy efficient computer, the Raspberry Pi, a large hard drive, and a very simple web server written in the Haskell web framework Happstack.

A Simple Upload Form Based on Happstack and Resumable.js

When I was looking for a suitable web framework, I explored several options but ended up to use Happstack Lite because I could compile it directly on the Raspberry Pi (model B+, running ARM v6). In comparison to other frameworks that I tried (Snap, Yesod, Scotty), I managed to actually compile Happstack Lite on Raspbian Jessie, which comes with GHC 7.6.3 (but no support for Template Haskell).

The source code of a simple demo server is located at my Github repository. This basically provides the server functionality to serve and exploit the excellent Resumable.js Javascript library. Resumable.js runs on modern browsers and makes use of the HTML5 File API. It allows to chunk large files on the client so that the server never has to handle files larger than e.g. 1 MB. A perfect fit for the small processing power of the Raspberry Pi! Also, the library allows a client to resume an upload should the connection be interrupted. Great for uploading all these large videos from the wedding over an unreliable Internet connection ;-)

To install the webserver on Raspbian Jessie, do:

  1. Log into the Raspberry Pi.
  2. Install some prerequisites, something along the lines of:

    sudo apt-get install ghc git
  3. Get the server source code from git:

    git clone https://github.com/bdoering/hs-pi-upload.git
  4. Edit the configuration at hs-pi-upload/src/Config.hs (which for the sake of simplicity is just a simple Haskell file). You will probably want to set up the upload directories to point to a location on an external hard drive. Just make sure that the paths actually exist.
  5. Then compile the source code:

    # cd to the directory containing the file "hs-pi-upload.cabal"
    cabal sandbox init
    cabal update
    cabal install # Get lots of coffee now, the Pi is slow!
  6. Finally, you can run the server with:


    This will start the server on port 8000 (the Happstack Lite default).

The actual upload form is served statically, and the file is actually the nearly unmodified demo from https://github.com/23/resumable.js/blob/master/samples/java/src/main/webapp/index.html. The server’s role is to check for each uploaded chunk if the chunk has already been uploaded, and upon completion of all chunk uploads, to reassemble the files into the final file.


The web server is admittedly very simple and has the following shortcomings (or features, depending on how you want to see it):

Some Notes on the Server Setup

Here are some more tips on how you may run the Happstack server on the Raspberry Pi and to make it reachable over the Internet. Of course, you will also need to modify the settings of your router so that port 80 is actually forwarded to the Raspberry Pi.

Free DNS

If you have a simple DSL connection like me, the publicly visible IP address of the Raspberry Pi will change regularly. So, we need a DNS entry. If you don’t want to pay and are OK with a “random” name for your server, there are several free services available. I personally like FreeDNS a lot as it allows me to set up more than one DNS entry for free easily.

Once you have registered, you can set up a subdomain (a Type A entry). If you then go to the page Dynamic DNS, you can find a wget command which you can add as an entry to the crontab running on the Raspberry Pi so that the DNS entry is updated automatically. My crontab entry (user root) looks something like this:

*/5 * * * * wget -q --read-timeout=0.0 --waitretry=5 --tries=400 --background http://freedns.afraid.org/dynamic/update.php?SEKRETKEYabcdefg1234567890ABCDEFGHIKKLM= -O /dev/null

Nginx configuration

Putting the Happstack upload server behind an Nginx server allows to easily run more than one server on the same machine. Also, we can easily define rewrite rules.

In this case, I just added the following server configuration to /etc/nginx/sites-enabled/default:

# Happstack server, running on port 8000
server {
      listen 80;
      server_name MYDNSNAME.mooo.com; # mooo.com is provided by FreeDNS

      rewrite ^/upload$ /static/html/upload.html redirect;

      location / {
               proxy_pass http://localhost:8000;
               proxy_redirect off;
               proxy_set_header Host $host;
               proxy_set_header X-Real-IP $remote_addr;
               proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
               client_max_body_size 10m;
               client_body_buffer_size 128k;
               proxy_connect_timeout 90;
               proxy_send_timeout 90;
               proxy_read_timeout 90;
               proxy_buffer_size 4k;
               proxy_buffers 4 32k;
               proxy_busy_buffers_size 64k;
               proxy_temp_file_write_size 64k;

Make sure to restart Nginx with service nginx restart after you modified the configuration.

Supervisor configuration

The HTML server should be started automatically whenever the Raspberry Pi reboots. Also, the server should be restarted automatically if it crashes. For this we can use Supervisor, a program which allows to monitor and control other processes.

My setup for the Happstack server looks very simple. The file /etc/supervisor/conf.d/hs-pi-upload.conf just contains the following:


To apply the changes, I restart Supervisor with service supervisor restart.


Running a compiled Haskell web server on the Raspberry Pi resulted in a surprisingly good performance. If you have a good DSL connection, uploads to this server are basically as fast as to any other cloud based services such as Dropbox. Pretty cool! And all that running on such humble hardware, powered 100 % by open source software.

But keep in mind: Now that you host the data, you also need to care for backups and make sure that the server keeps running — otherwise you’ll get calls quickly once you gave the upload link to some friends ;-)

Happy uploading!