root
/
threadr.lostcave.ddnss.de
3
1
Fork 2
Code Issues 1 Pull Requests Projects Releases Wiki Activity
The new home of the ThreadR Forum Engine https://threadr.lostcave.ddnss.de
1,170 Commits
3 Branches
0 Tags
7.5 MiB
Go 66.3%
HTML 24.4%
CSS 5.6%
Python 3.7%
 
 
 
 
Go to file
Joca bdf81e7c68 Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00
config Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00
handlers Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00
legacy everything: Delete everything, full project reset. Keep a copy of variable_grabbler in case we ever need it. 2025-06-15 02:25:56 +02:00
models Initial implementation of the chat feature. 2025-06-15 02:47:16 +02:00
static Implemented features for creating and deleting boards and threads, removed thread types, enhanced CSS for boards and comments 2025-06-15 02:44:03 +02:00
templates about page: move all page content into config/about.template, also rewrite most of said content 2025-06-15 02:47:16 +02:00
.gitignore gitignore: add gitignore 2025-06-15 02:47:16 +02:00
README.md README: rip out all the leftovers that are no longer relevant to the new implementation 2025-06-15 02:47:16 +02:00
go.mod Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00
go.sum Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00
main.go Ask admin credentials on initialize instead of defining them on config.json 2025-06-15 02:48:43 +02:00

README.md

Welcome to ThreadR Rewritten

This is the source code for the ThreadR Forum Engine, rewritten in Go. ThreadR is a free and open-source forum engine designed to allow users to host their own forum instances on personal web servers.

Project Overview

ThreadR was originally started as a school project in 2019 with the aim of creating a hybrid between a forum and a social media platform. It was built with PHP and (back then still) MySQL. After we finished school, it was temporarily abandoned. An attempt was made to revive it in 2020, open-sourcing the code and making some things configurable, but not much else happened. Here we are now, with a full rewrite in Go started in 2025.

Project Setup

This is for development only. Currently, ThreadR is not ready for production use.

Prerequisites

  • UNIX-like OS
  • Go (golang)
  • Mariadb

Setup Steps

  1. Create a mariadb user and database for ThreadR (the names can be changed):
CREATE USER threadr IDENTIFIED BY 'super secure password';
CREATE DATABASE `threadr`;
GRANT ALL PRIVILEGES ON `threadr`.* TO 'threadr';
  1. Create a config file: In the config subdirectory, cp config.json.sample config.json and edit it to suit your needs.
  2. Create an about page: Also in the config subdirectory, cp about_page.htmlbody.sample about_page.htmlbody and edit it to suit your needs.

Running the Application

After configuration, run the following command once to initialize the DB:

go run main.go --initialize

To start the ThreadR server, run this:

go run main.go

The server will start on port 8080 by default.

Contributing

We welcome contributions! Please join our Discord server to get in touch: discord.gg/r3w3zSkEUE.

License

ThreadR is licensed under the Apache 2.0 License. See LICENSE.md for details.

Authors: BodgeMaster, Jocadbz