Image manipulation is done by lwip. 3D renders are created with node-canvas / cairo.

There are usually a few open issues.
We welcome any opinions or advice in discussions as well as pull requests.
Issues tagged with show where we could especially need your help!

Please visit the website for details.

• You can follow us on twitter
• Open an issue on GitHub

• Install nodejs 12 (LTS)
• Install redis-server
• Run npm install
  If that fails, it's likely because because of node-canvas dependencies. Follow this guide to install them.
• Run npm start

Crafatar is now available at http://0.0.0.0:3000.

Download the docker image from releases (docker hub coming soon™️).

docker load -i crafatar-docker.tar
mkdir /path/to/crafatar-images

docker network create crafatar
docker run --net crafatar -d --name redis redis
docker run --net crafatar -v /path/to/crafatar-images:/crafatar/images -e REDIS_URL=redis://redis -p 3000:3000 crafatar:2.1.0

* Use this to avoid issues when you have a persistent redis database but an ephemeral storage

npm test

If you want to debug failing tests:

# show logs during tests
env VERBOSE_TEST=true npm test

It can be helpful to monitor redis commands to debug caching errors:

redis-cli monitor