Skip to content
Free and adless chess website, trying to scale
PHP JavaScript Shell
Pull request Compare This branch is even with ornicar:staticIndex.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Very fast Chess game designed to run on a small server and play hundreds of concurrent games. Allows to play with a friend or an Artificial Intelligence. Supports castling, en passant, selective promotion, color selection, check and mate detection, and move validation. Uses only open source languages: PHP 5.3, HTML5, Javascript and CSS. Powered by Symfony2 and jQuery 1.4.



I'm waiting for bug reports and feature requests in GitHub issue tracker

Users can give feedback in Uservoice


Lichess is built on Symfony2, which is under heavy development and has very few documentation at the moment.

It requires APC. It's a free and open opcode cache for PHP.

Get the code

git clone git://
cd lichess
git submodule init
git submodule update

Create data folder

mkdir lichess/data


Open your browser at http://myhostname/index_dev.php

Configure Artificial Intelligence

The default AI is crafty, a opensource program written in C.

Install crafty on Debian based distros:

sudo apt-get install crafty

If you can't or don't want to install crafty, you can use a Stupid AI:

# lichess/config/lichess.yml
parameters: "Bundle\LichessBundle\Ai\Stupid"


Before doing any modification to the code, you should be able to run the test suite. You need PHPUnit 3.5 installed.

Run all unit and functional tests

phpunit -c lichess
Something went wrong with that request. Please try again.