# Cecil

Cecil is an archived, self-hosted, Python-based notification platform with a Flutter web interface that uses ntfy to centralize notifications from self-hosted services. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2397/cecil

## Description

Cecil is an archived, self-hosted, Python-based notification platform with a Flutter web interface that uses ntfy to centralize notifications from self-hosted services.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

12/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/madeofpendletonwool/cecil
- Unraid: https://ca.unraid.net/apps/cecil-0js6fk805szxpo?q=Cecil
- GitHub: https://github.com/madeofpendletonwool/cecil

## Common questions

### How do I configure GitHub authentication for Cecil?

Set the CLIENT_ID, CLIENT_SECRET, and AUTH_URL environment variables in the Docker Compose file. AUTH_URL must be the URL used to reach Cecil, with /api/oauth/redirect appended.

### Which port does Cecil expose, and can I change it?

Cecil serves the Flutter web UI on port 38355 inside the container. You can map it to a different external-facing port in the Compose file.

### Where does Cecil store its configuration, and what permissions are required?

Cecil writes modules, data, and configuration to the mapped config folder. You should set 755 permissions on the folder because Cecil needs to write temporary files there.

### Do I have to run ntfy with Cecil?

Cecil assumes you are using ntfy. You can implement your own notification service if you want, but you are responsible for maintaining it.

### How should I deploy Cecil?

Cecil is containerized and can be deployed with a Docker Compose file. This is the setup method recommended in the project instructions.

---
Source: Our Local Host (https://ourlocalhost.com/app/2397/cecil), the self-hosted and open-source app directory.
