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.
Build the project
gem install compass git clone https://github.com/pixelpark/ppnet cd ppnet npm install -g gulp bower npm install bower install gulp
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 org.apache.cordova.camera phonegap plugin add org.apache.cordova.statusbar phonegap plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git phonegap plugin add https://github.com/apache/cordova-plugin-whitelist.git phonegap build android phonegap run android
To get ppnet running in three simple steps with docker, you have to do this.
git clone https://github.com/pixelpark/ppnet . docker build -t pixelpark/ppnet . docker run -d -p 8000:80 pixelpark/ppnet
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:
- simply download the zip file of this repository,
- navigate to the www directory (
- start a web server right there (
python -m SimpleHTTPServeror
python3 -m http.server)
- Navigate to
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.