Forumlite

Installation
Guide

Currently in development, Forumlite is a 100% free, open source, self-hosted web-based forum software that's light on resources and light on frustration. Built using Laravel, Bootstrap, and JavaScript. Here's how to install it.

1. Download the latest release

Start by going to GitHub and downloading the latest release.

2. Set up Environment

Option A: Docker

You can use Laravel Sail to quickly get a Docker container of Forumlite running on your system. This is the best way to try out Forumlite on your local machine. Assuming Docker is already set up on your system, you'll need to run a few commands to set up the Forumlite docker containers.

docker run --rm \
-u "$(id -u):$(id -g)" \
-v "$(pwd):/var/www/html" \
-w /var/www/html \
laravelsail/php83-composer:latest \
composer install --ignore-platform-reqs

Create a .env file and copy over the contents of .example.env. It is very important you do not leave the default settings. Don't forget to set up the connection to the email server!

You can either run sail commands using ./vendor/bin/sail or configure a shell alias: alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'

To start Forumlite, run sail up.

The first time you run Forumlite, you'll need to run the following commands:

sail artisan key:generate
sail artisan migrate
sail artisan db:seed
sail artisan storage:link

In addition, be sure to run sail artisan queue:work After each startup of Forumlite.

Option B: Linux Server

If you are going to use a Linux server, set up a typical LAMP stack on there, as well as composer. Upload the forumlite files to your server - most likely the correct place to upload the files would be /var/www/html, but this depends on your setup.

Create a .env file and copy over the contents of .example.env. It is very important you do not leave the default settings. Don't forget to set up the connection to the email server!

The first time you run Forumlite, you'll need to run the following commands:

php artisan key:generate
php artisan migrate
php artisan db:seed
php artisan storage:link

In addition, be sure to run php artisan queue:work After each startup of Forumlite.

3. Run the Installer

Keep in mind Forumlite can not be in a subfolder of your domain. So, you could put your forum at https://example.com or https://forum.example.com, but you could NOT use https://example.com/forum, for example.

Use your web browser to go to your forum's install page (/start) at wherever Forumlite is running, such as https://example.com/start or http://localhost/start. If everything is set up right, you should see a form to register your admin user. Clicking Submit will create that user, disable maintenance mode, disable future access to the installer.

Installation Complete!

Congrats, you did it! If you encounter any issues, please feel free to email the developer at michael (at) mstaake (dot) com.