Social & Search¶

Overview¶

FreshRSS - A self-hosted RSS feed aggregator
phpBB - Free flat-forum bulletin board software solution
WordPress - Website Blog and Publishing platform
Single File PHP Gallery - Host and browse your images from a web interface

Baïkal - Lightweight CalDAV + CardDAV server
Synapse - Decentralized communication with the Matrix protocol
microblog.pub - A self-hosted, single-user, ActivityPub powered microblog
MediaWiki - A collaboration and documentation platform

How do I run DietPi-Software and install optimised software items?

To install any of the DietPi optimised software items listed below run from the command line:

dietpi-software

Choose Browse Software and select one or more items. Finally select Install.
DietPi will do all the necessary steps to install and start these software items.

DietPi-Software menu screenshot

To see all the DietPi configurations options, review the DietPi Tools section.

Return to the Optimised Software list

FreshRSS¶

FreshRSS is a self-hosted RSS feed aggregator.

Access to the web interface

URL = <http://<your.IP>/freshrss
Username = dietpi
Password = <yourGlobalSoftwarePassword> (default: dietpi)

Official documentation: https://freshrss.github.io/FreshRSS/en/users/02_First_steps.html

phpBB¶

If you always wanted your very own forum, phpBB is all you need.

Also Installs:

Webserver, PHP and MariaDB

Access Forums¶

URL = http://<your.IP>/phpbb

First Run Setup¶

DietPi automatically creates the SQL database for phpBB. Please follow the steps below to enter those details into phpBB to complete the setup.

Access to the phpBB website¶

URL = http://<your.IP>/phpbb
Click the “Install” tab
Click “Proceed to next step”
Click “Start install”

MySQL/MariaDB database details¶

To enter the MySQL/MariaDB database details:

Database server hostname or data source name (DSN) = localhost
Database username = phpbb
Database name = phpbb
Database password = dietpi (respectively your chosen global software password)
Click “Proceed to next step”
Click “Proceed to next step”

Create your admin account¶

This account will be used for full access to phpBB forum.

Click “Proceed to next step”
Click “Proceed to next step”
Click “Proceed to next step”

Email and Server URL settings¶

Use the default values.

Click “Proceed to next step”
Click “Proceed to next step”

The database tables will now be generated, please wait.

Click “Login”
Using your admin login details that you created previously, you can now manage and create your forum pages.

As the installation is now completed, you will need to remove the installation folder, before the forum can be live. Run the following command:

rm -R /var/www/phpbb/install

Your forum is now ready.

Official website: https://www.phpbb.com/

WordPress¶

WordPress is a state-of-the-art semantic personal publishing platform with a focus on aesthetics, web standards, and usability. It allows you to create your own website.

Access to the web interfaceFirst time connect

URL = http://<your.IP>/wordpress

The first time you connect, enter the following MySQL database details:

Database name = wordpress
Username = wordpress
Password = your global application password
Database Host = localhost
Table Prefix = wp_

Actively fill all fields!

You need to fill out every dialog field although it seems like they are already set.

Remark: In the example screenshot the global application password is dietpi.

Official website: https://wordpress.org/

Single File PHP Gallery¶

Single File PHP Gallery allows you to host and browse your images from a web interface.

Also Installs:

Webserver and PHP

Access to Image GalleryAdd images

URL = http://<your.IP>/gallery

To add your own images:

Create your image folder
```
mkdir /var/www/gallery/MyImageFolder
```

Put an image file inside your new folder

wget https://dietpi.com/images/dietpi-logo_192x192.png
mv dietpi-logo_192x192.png /var/www/gallery/MyImageFolder/

Official website: https://sye.dk/sfpg
YouTube video tutorial: DietPi: Easily set up Raspberry Pi projects (e.g. a shared photo gallery)

Baïkal¶

Baïkal is a lightweight CalDAV + CardDAV server.

First run setupAccess the web interface

Access the setup page:

URL = http://<your.IP>/baikal/html
Enter a new admin password for your account, then click the next/save button.

Enter MySQL Details:

Use MySQL = Yes
MySQL host = 127.0.0.1
MySQL database name = baikal
MySQL username = baikal
MySQL password = your global software password (default: dietpi)

URL = http://<your.IP>/baikal/html/admin
Username = admin
Password = What you set during first run setup above.

Official website: https://sabre.io/baikal/

Synapse¶

Synapse is a server, written in Python, for communication using the Matrix protocol.

ClientFederationConfigurationService handlingView logsUpdate to latest version

For communicating with Synapse, you can use Element, however any client that supports the Matrix protocol should work.

Synapse is by default set up to be a private server, with no connection to any other servers. To connect to other servers (federate), see https://github.com/matrix-org/synapse/blob/develop/docs/federate.md.
Note that frp does not currently work with Synapse.

Config directory:
/mnt/dietpi_userdata/synapse
Main config file:
/mnt/dietpi_userdata/synapse/homeserver.yaml
DietPi config override:
/mnt/dietpi_userdata/synapse/homeserver.yaml.d/00-dietpi.yaml
This also contains the PostgreSQL database details and that file is hence only readable to root or the synapse user.

To add or change settings, best practice is to create a new override configuration, e.g.:

/mnt/dietpi_userdata/synapse/homeserver.yaml.d/99-local.yaml

For changes to take effect, the service needs to be reloaded:

systemctl reload synapse

The DietPi Synapse implementation creates a systemd service synapse.service to start and control the Synapse server. The following commands can be used:

Start: systemctl start synapse
Stop: systemctl stop synapse
Restart: systemctl restart synapse
Reload config: systemctl reload synapse
Print status: systemctl status synapse

Logs are done to the system journal an can be viewed via:

journalctl -u synapse

Since Synapse is installed via Python 3 pip, you can update it via:

pip3 install -U matrix-synapse

Official website: https://matrix.org/
Official documentation: https://matrix.org/docs/
Source code: matrix-org/synapse
License: Apache 2.0

microblog.pub¶

A self-hosted, single-user, ActivityPub powered microblog.

Installation / configurationConfiguration file

The software installs automatically with a default config. Therefore it is necessary to reconfigure it using the microblog-pub script, which loads the environment, and brings up the app’s own configuration wizard.
This circumstance is signalled with the following dialog at the end of the installation process:

To execute this reconfiguration, you can enter the following commands:

exec bash

This starts a new bash where you can execute the configuration script

microblog-pub configure

Remark: You can also easily reboot your system and then execute the microblog-pub configure command without the bash command before.

Setting the port number during the reconfiguration process

During the reconfiguration via microblog-pub configure you are asked - amongst others - for your domain.
Do not forget to add a :8007

The microblog.pub configuration file is named profile.toml
and is located there: /mnt/dietpi_userdata/microblog-pub/data/profile.toml.

In case of a full reconfiguration you need to delete this file before starting the microblog-pub configure command.

Official website: https://microblog.pub/

MediaWiki¶

This collaboration and documentation platform was originally developed for and is used by Wikipedia.

Quick start

MediaWiki is accessible via regular HTTP/HTTPS ports 80/443 below the /wiki path:

URL: http://<your.IP>/wiki

On first access, you need to go through the setup wizard. Enter the following database information:

Database type: MariaDB, MySQL, or compatible
Database host: localhost
Database name: mediawiki
Database table prefix: Since we use a dedicated database, you can leave this empty.
Database username: mediawiki
Database password: <your global password> (default: dietpi)

The next steps allow you to create an admin user to use for subsequent logins and setup wiki details. As last setup step you need to download the generated LocalSettings.php and upload it or copy and paste the content to /var/www/wiki/LocalSettings.php. When done, you can access your wikis main page, login with the previously created admin user and start creating content.

Official website: https://www.mediawiki.org/wiki/MediaWiki
Source code: wikimedia/mediawiki
License: GPLv2