This service can be used to create a social network, either temporarily or permanently for a group of users
JavaScript HTML Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.cordova use the phonegap camera plugin for image selection May 6, 2014
adaption Added adaption directory, added nologin-description Feb 5, 2016
apkbuild Added apkbuild Dec 22, 2015
app Merge develop Apr 15, 2016
hooks angular-client-side-auth extended and wall Sep 15, 2014
init A short script to rewrite the client side remote-databases in the con… Mar 16, 2015
platforms FCTWO-190 Jan 16, 2014
plugins FCTWO-190 Jan 16, 2014
server Bugfixing. Jan 29, 2016
tests Update Mar 20, 2015
www Update config.json Apr 4, 2016
.bowerrc New Folder Structure, Build System with Gulp, Bower Components Apr 17, 2014
.gitattributes Init Dec 20, 2013
.gitignore Bugfixing. Jan 29, 2016
.gitmodules removed submodule proxy Mar 17, 2015
.jshintrc Refactor Images Apr 29, 2014
.tern-project Optimierung Feb 17, 2014 updated script for ubuntu 12 Mar 19, 2015
Dockerfile Update Dockerfile Mar 31, 2015 Added FAQ. Apr 9, 2015 added mit license Feb 19, 2014
Makefile A simple swarm.son and Makefile to get ppnet running on Giantswam Feb 20, 2015 Not langer maintained. Mar 3, 2018
bower.json Integrated search, bugfixing, cleanup Feb 2, 2016
config.rb Improved compass task of gulpfile. Jul 22, 2015
gulpfile.js Added filter-folder to injections Feb 5, 2016
package.json updated some gulp-tasks; angular router-ui instead of ng-route, bette… Jan 31, 2016
playground.json updated palyground.json Mar 17, 2015
swagger.json Initial swagger.json May 8, 2015
swarm.json A simple swarm.son and Makefile to get ppnet running on Giantswam Feb 20, 2015


March, 2018: This project is not maintained any more!

What is this?

"We need something like Facebook, but just not Facebook." If you heard that from your client, or thought that yourself, PPnet might be for you.

Create and host your own social network. With some simple steps you can get it in less then 15 minutes. This project is partly funded by the Europian Union through the FI-CONTENT.

Version 2.0

PPnet is built as a single page application (SPA) in the JavaScript framework AngularJS, and uses a PouchDB/CouchDB combination for data synchronisation. The nice thing about this architecture is that you only need a CouchDB as a server side component (plus a simple HTTP Server) and that it works in online/offline mode. Additionally, it can authenticate against OAuth2 comaptible providers (like KeyRock).



Build the project

gem install compass
git clone
cd ppnet
npm install -g gulp bower
npm install
bower install

Build the Phonegap/Cordova App

The project must be build.

gulp build

cordova platform add android
cordova platform add ios

phonegap plugin add org.apache.cordova.device-orientation
phonegap plugin add org.apache.cordova.file
phonegap plugin add org.apache.cordova.file-transfer
phonegap plugin add org.apache.cordova.device
phonegap plugin add
phonegap plugin add org.apache.cordova.statusbar
phonegap plugin add
phonegap plugin add

phonegap build android
phonegap run android


To get ppnet running in three simple steps with docker, you have to do this.

git clone .
docker build -t pixelpark/ppnet .
docker run -d -p 8000:80 pixelpark/ppnet

Giant Swarm

If you are familiar with Docker, you are just one step away from your PPnet running - you will find it in this README.

It should be noted that we built the Docker environment in collaboration with the friendly people from Giant Swarm. Their startup is based on the idea of handling Docker containers in a simple way.

Steps for a simple quickstart

If you don't want to go through the hassle of installing development tools you can test PPnet by following these steps:

  1. simply download the zip file of this repository,
  2. navigate to the www directory (cd www)
  3. start a web server right there (python -m SimpleHTTPServer or python3 -m http.server)
  4. Navigate to http://localhost:8000

You should see PPnet with that latest entries of our test database.

To connect to your own database, you only need to change the remoteentry in the config file to a running, CORS enabled CouchDB. Changing this is the minimum thing you want to do to create your own database for your own social network. You will want to change the other entries too, to change the name of the application, the default location and so forth.

#Server / Proxy If you want to run PPnet behind a Proxy, especially the connection to the CouchDB, you should use server.js. You find the file and a readme in the folder "server".

#Video There is a somewhat outdated video of PPnet in action which will updated soon.


You can find more build instructions here.


The FAQ is here.