Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


  • Install dependencies with composer using composer install
  • Install client-side dependencies with npm using npm install
  • Install webpack npm install -g webpack
  • Make an empty MySQL database.
  • Copy includes/config.example.php to includes/config.php and get editing.
  • Run php includes/upgrade.php from the command line.
  • Run webpack -d --watch
  • Enable the apache2 rewrite module: a2enmod rewrite
  • Optional: Edit .htaccess

On a fresh Ubuntu/Debian installation you will likely want apt-get install apache2 libapache2-mod-php php php-bcmath php-curl php-mysql php-apcu mysql-server mysql-client and configure your php.ini as follows:

display_errors = On
display_startup_errors = On
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE

Depending on your setup it may also be necessary to configure your php.ini to use UTF-8 internally so exotic tripcodes get converted correctly:

mbstring.internal_encoding = UTF-8

It is also possible to use nginx, and a sample rewrite.conf is available, but this is currently not officially supported.

When deploying to production use webpack -p.


Update your working tree (git pull?) and run the following commands. See the wiki for scripts used by

composer install
npm install
webpack -p
php includes/upgrade.php


If you have any questions you can try your luck on the issue tracker or ##minichan @ Note that development is primarily geared towards running a functional so your feature requests may not be a priority. Pull requests are welcome if they are discussed on the issue tracker or IRC (with r04r) first.

And yes. The code is shit. :-)


This repository consists of four primary branches, of which all but master may have their histories rewritten at any time:

  • master: The main development branch. The code on this branch should work, but may not be fully functional or stable when development is happening. If you intend to submit pull requests base them off of this branch.
  • testing: - For testing new changes in a staging setup
  • beta: - For testing new changes in a staging setup, with a shared database with Database changes will not be tested here.
  • minichan:
You can’t perform that action at this time.