Home

Awesome

nomadForum

A forum on the NomadNetwork

Status:

Working, but there are many missing features and data loss may occur. This software is in an alpha state.

Selfhosting

Installation

  1. Install and configure Nomad Network
  2. Download the source code git clone https://codeberg.org/AutumnSpark1226/nomadForum ~/.nomadnetwork/storage/pages/nomadForum You can change the folder after ./pages to your liking. Put the code in ~/.nomadnetwork/storage/pages if you only want the forum on your node.
  3. cd into the folder. Use git checkout tags/VERSION to use a specific realease version (Once one is released)
  4. Install all requirements pip install -r requirements.txt
  5. Modify main.py:
  1. Create an admin account by running admin/create_admin_account.py Enter your username and password.
  2. (Re)Start nomadnet. The forum should be available now.

[OPTIONAL] Enable notifications

Notifications work by running notify.py as background service.

  1. Modify notify.py
  1. Setup notify.py to run as a daemon. This might work in many different ways depending on your system. A configuration file for systemd might look like this:
[Unit]
Description=NomadForum notification service
DefaultDependencies=no

[Service]
Type=simple
User=user
Group=group
ExecStart=/home/user/.nomadnetwork/storage/pages/nomadForum/notify.py

[Install]
WantedBy=default.target

Modify it to match your setup. Make sure to run the daemon as the same user that runs nomadnet.

  1. Start the daemon.
  2. Make sure to set notifications_enabled to True in main.py

Updating

  1. cd into the source code folder.
  2. Use git to switch to the new version.
  3. Try loading a page. If you get CRITICAL: Database migration required! Contact an admin!, you need to run ./admin/migrate.py

Management options

Code hosting

The code is available on codeberg and on github