---
title: Caelestis
description: >-
  Caelestis adds image templates and painting tools to Wplace. Import your
  artwork, place it on the map, and adjust the overlay to see where each colour
  belongs. You can use it on your own without a server.
---

# Caelestis

Caelestis adds image templates and painting tools to [Wplace](https://wplace.live). Import your artwork, place it on the map, and adjust the overlay to see where each colour belongs.

You can use it on your own without a server. A server lets a group share templates, track progress, and see where others are working. The web dashboard shows those templates and their history outside Wplace.

![A template placed on Wplace, with the Caelestis template panel open.](https://docs.caelest.is/images/overview/templates-and-overlay.png)

## Start painting

[Install the userscript](https://docs.caelest.is/start-here/install-the-userscript.md), then follow [Getting started](https://docs.caelest.is/start-here/getting-started.md) to place your first template.

| I want to… | Read |
| --- | --- |
| Import, move, or organise artwork | [Templates](https://docs.caelest.is/use-caelestis/templates.md) |
| Change pixel styles, outlines, or markers | [Overlay and painting](https://docs.caelest.is/use-caelestis/overlay-and-painting.md) |
| Join a group's server | [Connect to a server](https://docs.caelest.is/start-here/connect-to-a-server.md) |
| Track progress or paint with others | [Progress and collaboration](https://docs.caelest.is/use-caelestis/progress-and-collaboration.md) |
| Change sharing settings or keyboard shortcuts | [Settings and shortcuts](https://docs.caelest.is/use-caelestis/settings-and-shortcuts.md) |
| View templates and timelapses in a browser | [Dashboard](https://docs.caelest.is/use-caelestis/dashboard.md) |

## Run a server

The backend stores shared artwork and progress. The frontend serves the dashboard. You can run both with [Docker](https://docs.caelest.is/run-a-server/run-with-docker.md) or on [Cloudflare](https://docs.caelest.is/run-a-server/deploy-on-cloudflare.md).

[Self-hosting](https://docs.caelest.is/run-a-server/self-hosting.md) compares the deployment options. The Docker guides cover SQLite, PostgreSQL, MariaDB, CNPG, and S3 storage separately.

## Project links

- [GitHub releases](https://github.com/mia-cx/Caelestis/releases)
- [Official dashboard](https://caelest.is)
- [The Quilt Discord](https://discord.gg/thequilt)
- [Report a bug](https://github.com/mia-cx/Caelestis/issues/new/choose)
- [Contribute](https://docs.caelest.is/development/contributing.md)
