Vichan

Vichan puts the Party in soyjak.party!

soyjak.party would literally not exist without vichan!

Vichan is an imageboard software used by soyjak.party. Created by a random polak from Tinyboard fork, and written in PHP. The software was once maintained by KolymaNET until its dissolution. Currently, Angeleno and Weav are the maintainers of Vichan.

Quote plans to move the software to his own in-house version called Quotechan, instead written in Go.

Vichan Installation and Setup Guide

Vichan is a lightweight, fast, and highly configurable PHP-based imageboard software. This guide covers the installation process, basic configuration, and upgrade instructions.

Overview

Vichan is a fork of Tinyboard that aims to provide a user-friendly imageboard solution. It supports PHP 7.4 and later (with PHP 8.1 supported as of August 2022), and works with MySQL/MariaDB. Additional PHP extensions like mbstring, GD, and PDO are required.

Prerequisites

Before installing Vichan, ensure your server meets these requirements:

• Operating System: A Unix-like OS (FreeBSD or GNU/Linux is recommended)
• PHP: Version 7.4 or higher
• Database: MySQL or MariaDB (MySQL/MariaDB >= 5.5.3 is recommended)
• PHP Extensions: mbstring, PHP GD, and PHP PDO
• Optional Tools:

 * ImageMagick (for image processing)
 * APCu, Memcached, or Redis (for caching)

Installation Steps

Below are the steps to install Vichan:

1. Clone the Repository

Open your terminal and run: git clone git://github.com/vichan-devel/vichan.git

2. Install Dependencies

Navigate to the cloned directory and run Composer to install dependencies: cd vichan composer install

• Note: Make sure you have Composer installed.*

3. Run the Installer

Using your web browser, navigate to: http://your-domain.com/install.php Follow the on-screen prompts to configure your database, site settings, and other options.

4. Set Up the Administrator Account

After the installation, access the moderation panel at: http://your-domain.com/mod.php Log in using the default credentials:

• Username: admin
• Password: password

Immediately change the administrator password after the first login in order to prevent a Captain Coal Attack.

Optional Configurations

• Oekaki Support:

Vichan supports oekaki via wPaint. Initialize and update the submodule by running: git submodule init git submodule update Then, add the scripts listed in js/wpaint.js to your instance-config.php file.

• WebM Support:

For enabling WebM support, refer to the file: inc/lib/webm/README.md

• Docker Setup:

Vichan includes a Dockerfile and a docker-compose configuration. For development or testing using Docker, see the documentation in: docker/doc.md

Upgrading Vichan

To upgrade an existing Vichan installation (or to migrate from Tinyboard):

1. If you used Git, update your files with:

git pull

1. Alternatively, if you did not use Git, back up your inc/instance-config.php, replace the files (ensuring that board data remains intact), restore the configuration file, and run install.php.

Remarkable Default Pages

Vichan includes several pre-built pages that form the core of its functionality. These pages are automatically installed and are essential for both user and moderator interactions:

• install.php – Guides you through the installation and initial configuration of your imageboard.
• mod.php – The moderator control panel for administering the board.
• post.php – Processes new posts and displays them on the board.
• search.php – Enables users to search for content on the imageboard.
• report.php – Allows users to report posts or content that violates board rules.
• banned.php – Displays whether you are banned or not.
• log.php – Provides access to system and moderation logs.
• player.php – Manages media content playback (where applicable).
• securimage.php – Handles CAPTCHA functions to help prevent spam.
• smart_build.php – A command-line tool used for building or managing specific aspects of the board.

Support and Contributions

Vichan is currently in beta, and you might encounter bugs. Please:

• Report issues on the GitHub Issues page
• Contribute by submitting pull requests, patches, or documentation improvements

External links

• Repository