Skip to content
Gen2 edited this page Jul 2, 2017 · 5 revisions

Preparation

Ensure your web server, MySQL installation, PHP, and other things are working as they should. Clear out the document root where you want to install NPFchan, and clone the NPFchan repo to the document root directly. Set appropriate permissions on relevant directories.

Note:

Due to the insecurity of the default password (password) you may want to run the initial installation without being exposed to the public Internet.

Installation

Run install.php. You will encounter an error. You should probably read my upstream bug report at https://github.com/vichan-devel/vichan/issues/229 for details. In addition to this error, you will get another error later on related to tables not existing. To get around this, you need to make sure that inc/instance-config.php has your database details defined, and you need to run the following scripts:

UPDATE_SCRIPT__SHADOW_DELETE.php
UPDATE_SCRIPT__ARCHIVING_OF_THREADS.php
UPDATE_SCRIPT__MOD_ARCHIVE_FOR_THREADS.php
UPDATE_SCRIPT__ARCHIVE_VOTING.php

Do note that you will need to login to mod.php for any of these scripts to be ran. (Default username and password: admin/password)

UPDATE_SCRIPT__HASHING_OF_IP_ADDRESSES.php is only used for vichan migrations and upgrades from versions of NPFchan which did not support IP hashing at the time.

Once you have run those scripts, you should be good to go. You may want to run install.php again. In any case, make sure .installed is present.

Troubleshooting

White page of death

Make sure you installed the dependencies listed in README.MD, and restart php-fpm. If you get offered a download for install.php, you've incorrectly configured NGINX.