Skip to content
slack based chess client
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Godeps updated dep, url now marks origin and destination square of last move Mar 29, 2016
internal /chess help text updated, readme updated Apr 1, 2016
.travis.yml changed travis to run on ubuntu 14.04 Apr 1, 2016


Build Status

How can you play chess on any device?


This project gives you a turn key solution for tranforming slack into a chess client. With slackchess you can:

  • challenge another slack user
  • play against @slackbot powered by Stockfish
  • offer draws and resign
  • export your game as a PGN


Installation Guide

To start the Slack Integration Guide you will need the IP or URL of your server. If you don't already have a place to host slackchess, you can follow the Digital Ocean Setup Guide first. After the Slack Integration is setup, you should follow the Server Setup Guide. The Server Setup Guide will guide you through pulling down the docker image and running it as a container.

Digital Ocean Setup Guide

  1. Signup for Digital Ocean if you don't have an account ( referal link to get $10 free)
  2. Click Create Droplet
  3. Select One-click Apps > Docker
  4. Choose smallest size
  5. Make sure to add your SSH keys (if you need help click "New SSH Key > How to use SSH keys")
  6. Select 1 droplet
  7. Click Create

Slack Integration Guide

  1. Login to Slack and go to
  2. Go to Configure > Custom Integrations > Slash Commands > Add Configuration
  3. For "Choose a Command" type "/chess" and press "Add Slash Command Integration"
  4. Set "URL" to where "" is your IP
  5. Make sure "Method" is POST
  6. Copy and paste the generated "Token" somewhere, you will need it later
  7. For "Customize Name" you can enter anything (ex. "ChessBot")
  8. For "Customize Icon" I used this image:
  9. Click "Save Integration"

slack integration

Server Setup Guide

If you added your SSH keys to your local machine (you should have in the Digital Ocean Setup Guide), you can SSH into your machine. Replace "" with your IP.

ssh root@

Pull down the docker image from Docker Hub.

docker pull loganjspears/slackchess

Create and run a docker container with your information. Replace "R546Sk2RoZiAXZltssJ4WfEO" with your Slack token. Replace "" with your IP.

docker run -d -p 80:5000 -e TOKEN=R546Sk2RoZiAXZltssJ4WfEO -e URL= loganjspears/slackchess

If everything worked the ps command should show the container running.

docker ps

Thats it!


Play against user:

/chess play @user

Play against bot:

/chess play @slackbot

You can view all commands by using the help command.

/chess help


You can’t perform that action at this time.