Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Jan 30, 2013

THIS SOFTWARE HAS BEEN ABANDONED IN 2013 AND IS NO LONGER UPDATED NOR SUPPORTED! However, you can still use it for whatever reasons you require, there's just no support - you need to fix any bugs yourself.

This is the board software of, now released under the MIT license. See LICENSE for details.


  • Apache2 or Nginx
  • PHP5 (recommended version 5.5)
  • Mysql5 server (recommmended version 5.6+)
  • The following PHP libraries: mysql, curl, imagick, gd, geoip
  • ImageMagick for image conversions and resizing


  • PHP-APC for upload progress (Please note that the current version of PHP-APC segfaults (=crashes) on PHP5.4+!)
  • tmpfs (/dev/shm) for faster file caching, other option is tmp/ -folder in installation root.
  • GifSicle for gif resizing and animated gif support
  • PNGCrush and OptiPNG for png optimization
  • MP4Box for mp4 streaming support


This guide is for Debian based distros. Needs some changes for other distros.

I'm going to assume you already have a functional web server with Apache2/mod_php or Nginx/PHP-FPM and a MySQL server running.

If you cannot install the gpac -package, you might need to add to sources.list. See the prior link for more information and guides.

  1. Install required PHP-libraries and software:
  • apt-get install php-apc php5-mysql php5-curl php5-imagick imagemagick gifsicle libjpeg-progs optipng pngcrush php5-gd gpac php5-geoip
  1. Ensure the required apache2 rewrite-module is active by running the following command:
  • a2enmod rewrite
  1. Activate apc.rfc1867 by adding a line "apc.rfc1867 = 1" to /etc/php5/(apache2|fpm)/conf.d/apc.ini
  • Even though this is optional, it is required for file upload progress to work. Don't forget to restart the web server afterwards.
  1. Git clone or in any other way download the code to a web server public root

  2. Create a database for the application

  3. Modify inc/config.php.sample as required and rename it to inc/config.php when done.

7a. (Apache) Check the .htaccess file if you need to edit it (for example for SSL). 7b. (Nginx) Edit install/nginx.conf.sample as required and copy it to nginx sites-available and symlink to sites-enabled, then reload nginx.

  1. Open http://your.url/install/install.php in your web browser and follow the installation procedure.
  • This step inserts the SQL dump into the database and allows you to add an admin account.
  1. Delete the whole install -folder!

  2. Create the folder tmp/ and make it writable by the web server (for example: mkdir /path/to/installation/tmp && chown -R www-data /path/to/installation/tmp && chmod -R 744 /path/to/installation/tmp).

  3. Give proper permissions for the board to create the files/ -folder and all subfolders. The easiest way is of course "chmod -R /path/to/installation 777", but this is also the least secure.

  4. Open http://your.url/ and you should see the board open!

  5. To add boards, you need to issue the commands to the database directly, because the administration panel is incomplete. You can use PHPMyAdmin for example.

  • First add a category into the "categories" -table. Only the "name" -column is required. Note the ID of the inserted row (most likely 1).
  • Then add a board into "boards" -table. The only required values are url (ex. "b" - without any slashes!), name (ex. "Random") and category (the id of the inserted category (ex. "1"), required for the board to show up in the menus). "Worksafe" could be set to "1" to disable the hiding when NSFW is hidden.

Installation notes

  • If you are using the native gettext (and not the slow php-lib), you need to generate server locales to support other languages. Eg. fi_FI.UTF-8 to have finnish working.
  • GeoIP requires the MaxMind binary packages, see more by googling for PHP-GeoIP usage.

Included software

This release also includes some other software freely available from the internet. Their licenses may differ from NorthBoard.


Blinkenworld, which was included before, is now moved to a separate repository:


THIS SOFTWARE HAS BEEN ABANDONED IN 2013 AND IS NO LONGER UPDATED NOR SUPPORTED! The used-to-be board software of, available under the MIT licence.




No releases published


No packages published