Build a private social network with a Raspberry Pi |

Build a private social network with a Raspberry Pi

Step-by-step instructions on how to create your own social network with low-cost hardware and simple setup.

Team of people around the world

Subscribe now

Get the highlights in your inbox every week.

Social networks have revolutionized people's lives in the last several years. People use social channels every day to stay connected with friends and family. But a common question remains regarding privacy and data security. Even if social networks have created complex privacy policies to protect users, maintaining your data in your own server is always the best option if you don't want to make them available to the public.

Again, a Raspberry Pi—Raspbian Lite version can be very versatile to help you put a number of useful home services (see also my Raspberry Pi projects article) in place. Some addictive features can be achieved by searching for open source software and testing it with this fantastic device. An interesting example to try is installing OpenSource Social Network in your Raspberry Pi.

What Is OpenSource Social Network?

OpenSource Social Network (OSSN) is a rapid-development social networking software written in PHP, that essentially allows you to make a social networking website. OSSN can be used to build different types of social apps, such as:

  • Private Intranets
  • Public/Open Networks
  • Community

OSSN supports features like:

  • Photos
  • Profile
  • Friends
  • Smileys
  • Search
  • Chat

OSSN runs on a LAMP server. It has very poor hardware requirements, but an amazing user interface, which is also mobile-friendly.

What we need

This project is very simple and, because we're installing only remote web services, we only need a few cheap parts. I'm going to use a Raspberry Pi 3 model B+, but it should also work with Raspberry Pi 3 model A+ or newer boards.


  • Raspberry Pi 3 model B+ with its power supply
  • a micro SD card (better if it is a performing card, at least 16GB)
  • a Desktop PC with an SFTP software (for example, the free Filezilla) to transfer installation packages into your RPI.

Step-by-step procedure

We'll start by setting up a classic LAMP server. We'll then set up database users and install OpenSource Social Network.

1. Install Raspbian Buster Lite OS

For this step, you can simply follow my Install Raspbian Buster Lite in your Raspberry Pi article.

Make sure that your system is up to date. Connect via ssh terminal and type following commands:

sudo apt-get update
sudo apt-get upgrade
2. Install LAMP server

LAMP (Linux–Apache–Mysql–Php) servers usually come with the MySQL database. In our project, we'll use MariaDB instead, because it is lighter and works with Raspberry Pi. 

3. Install Apache server:

sudo apt-get install apache2 -y
You should now be able to check that Apache installation has gone correctly by browsing http://<<YouRpiIPAddress>>:

4. Install PHP:

sudo apt-get install php -y
5. Install MariaDB server and PHP connector:
sudo apt-get install mariadb-server php-mysql -y
6. Install PhpMyAdmin:

PhpMyAdmin is not mandatory in OpenSource Social Network, but I suggest that you install it because it simplifies database management.

sudo apt-get install phpmyadmin
In the phpMyAdmin setup screen, take the following steps:
  • Select apache (mandatory) with space and press OK.
  • Select Yes to configure the database for phpMyAdmin with dbconfig-common.
  • Enter your favorite phpMyAdmin password and press OK.
  • Enter your phpMyAdmin password again to confirm and press OK

7. Grant phpMyAdmin user DB privileges to manage DBs:

We'll connect to MariaDB with root user (default password is empty) to grant permissions. Remember to use semicolons at the end of each command row as shown below:

sudo mysql -uroot -p
grant all privileges on *.* to 'phpmyadmin'@'localhost';
flush privileges;
8. Finally, restart Apache service:
sudo systemctl restart apache2.service
And check that phpMyAdmin is working by browsing http://<<YouRpiIPAddress>>/phpmyadmin/. 

Default phpMyAdmin login credentials are:

  • user: phpmyadmin
  • password: the one you set up in the phpMyAdmin installation step

Installing other open source social network-required packages and setting up PHP

We need to prepare our system for OpenSource Social Network's first setup wizard. Required packages are:

  • PHP version any of 5.6, 7.0, 7.1
  • MYSQL 5 OR >
  • PHP Extensions cURL & Mcrypt should be enabled
  • PHP GD Extension
  • PHP ZIP Extension
  • PHP settings allow_url_fopen enabled
  • PHP JSON Support
  • PHP XML Support
  • PHP OpenSSL

So we'll install them with following terminal commands:

sudo apt-get install php7.3-curl php7.3-gd php7.3-zip php7.3-json php7.3-xml

1. Enable MOD_REWRITE:

sudo a2enmod rewrite
2. Edit default Apache config to use mod_rewrite:
sudo nano /etc/apache2/sites-available/000-default.conf
3. Add the section so that your 000-default.conf file appears like the following (excluding comments):
<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
    # SECTION TO ADD --------------------------------
        <Directory /var/www/html>
            Options Indexes FollowSymLinks MultiViews
            AllowOverride All
            Require all granted
    # END SECTION TO ADD --------------------------------
4. Install Mcrypt:
sudo apt install php-dev libmcrypt-dev php-pear
sudo pecl channel-update
sudo pecl install mcrypt-1.0.2
5. Enable Mcrypt module by adding (or uncommenting) “" in "/etc/php/7.3/apache2/php.ini":
sudo nano /etc/php/7.3/apache2/php.ini
allow_url_fopen should be already enabled in "/etc/php/7.3/apache2/php.ini". OpenSSL should be already installed in php7.3.

6. Another setting that I suggest is editing the PHP max upload file size up to 16 MB:

sudo nano /etc/php/7.3/apache2/php.ini
7. Look for the row with the upload_max_filesize parameter and set it as the following:
upload_max_filesize = 16M
8. Save and exit. Restart Apache:
sudo systemctl restart apache2.service

Install OSSN

1. Create DB and set up user:

Go back to phpmyadmin web page (browse "http://<<YourRpiIPAddress>>/phpmyadmin/") and login:

User: phpmyadmin

Password: the one set up in phpmyadmin installation step

Click on database tab:

Create a database and take note of the database name, as you will be required to enter it later in the installation process.

It's time to create a database user for OSSN. In this example, I'll use the following credentials:

User: ossn_db_user

Password: ossn_db_password

So, terminal commands will be (root password is still empty, if not changed by you before):

sudo mysql -uroot -p
CREATE USER 'ossn_db_user'@'localhost' IDENTIFIED BY 'ossn_db_password';
GRANT ALL PRIVILEGES ON ossn_db.* TO 'ossn_db_user'@'localhost';
flush privileges;
2. Install OSSN software:

Download the OSSN installation zip file from the OSSN download page on your local PC. At the time of this writing, this file is named ""

Using your favorite SFTP software, transfer the entire zip file via SFTP to a new folder in the path "/home/pi/download" on your Raspberry Pi. Common (default) SFP connection parameters are:

  • Host: your Raspberry Pi IP address
  • User: pi
  • Password: raspberry (if you didn't change the pi default password)
  • Port: 22

Back to terminal:

cd /home/pi/download/ #Enter directory where OSSN installation files have been transferred
unzip #Extracts all files from zip
cd /var/www/html/ #Enter Apache web directory
sudo rm index.html #Removes Apache default page - we'll use OSSN one
sudo cp -R /home/pi/download/ossn-v5.2-1577836800/* ./ #Copy installation files to web directory
sudo chown -R www-data:www-data ./
Create a data folder:OSSN requires a folder to store data. OSSN suggests, for security reasons, to create this folder outside of the published document root. So, we'll create this opt-in folder and give grants:
sudo mkdir /opt/ossn_data
sudo chown -R www-data:www-data /opt/ossn_data/
Browse http://<<YourRpiIPAddress>> to start the installation wizard:

All checks should be fine. Click the Next button at the end of the page.

Read the license validation and click the Next button at the end of the page to accept.

Enter the database user, password, and the DB name you chose. Remember also to enter the OSSN data folder. Press Install.

Enter your admin account information and press the Create button.

Everything should be fine now. Press Finish to access the administration dashboard.

So, administration panel can be reached with URL "http://<<YourRpiIPAddress>>/administrator" while user link will be "http://<<YourRpiIPAddress>>".

This article was originally published at Reposted with permission.

Hands holding a mobile phone with open on the screen

A photo-sharing platform, a privacy-friendly social network, and a web application for building and sharing portfolios.
people in different locations who are part of the same team

Check out these five open source applications that keep your personal data private.


About the author

Giuseppe Cassibba - Lucky husband, open source passionate. Curious by nature. Proud of my roots, happy to mix and learn from different roots