Skip to content

Social & Search

Overview

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.

FreshRSS screenshot

  • 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

phpBB example forum screenshot

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.

Login

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.

WordPress logo and usage pictogram

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.

WordPress database initialization dialog

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


Official website: https://wordpress.org/

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

Also Installs:

  • Webserver and PHP

Single File PHP Gallery web interface screenshot

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.

Baïkal web interface screenshot

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.

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.

microblog.pub blog screenshot

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:

microblog.pub installation screenshot

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://sr.ht/~tsileo/microblog.pub/

MediaWiki

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

Restic logo

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:

  1. Database type: MariaDB, MySQL, or compatible
  2. Database host: localhost
  3. Database name: mediawiki
  4. Database table prefix: Since we use a dedicated database, you can leave this empty.
  5. Database username: mediawiki
  6. 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

soju

soju is an IRC bouncer – it connects to upstream IRC servers on your behalf, and then you can connect to it using multiple IRC clients. This causes chat history to be preserved without having to have the IRC client connected all the time.

By default, soju listens on the 6667 port, which is the default for plain text (insecure) IRC connections.

The configuration file is /mnt/dietpi_userdata/soju/config. Its structure and configuration options are described in the soju man page.


Official website: https://soju.im
Source code: https://git.sr.ht/~emersion/soju

Return to the Optimised Software list