# Octofree

Octofree is a Discord notification tool for Octopus Energy customers that monitors scheduled free-electricity saving sessions and alerts you before they start and end. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3143/octofree

## Description

Octofree is a Discord notification tool for Octopus Energy customers that monitors scheduled free-electricity saving sessions and alerts you before they start and end. It scans the Octopus Energy free-electricity page, tracks the next session, sends a Discord webhook notification when a session is scheduled, and sends reminders five minutes before the start and three minutes before the end. It is intended for self-hosters who want a lightweight, GUI-less reminder for free electricity periods.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

25/100 (Low), based on 4 of 4 factors.
- Maintained: 34 (last commit 388 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/octofree-0dqbmj11faykj5?q=Octofree
- GitHub: https://github.com/dopeytree/octofree

## Common questions

### Do I need a reverse proxy or open port for Octofree?

The README does not document a web UI, reverse proxy, or required port; it sends alerts through a Discord webhook.

### What should I mount to keep Octofree data between restarts?

Bind-mount a host folder to /data and set OUTPUT_DIR=/data, or another mounted path, so output files and state are persisted on the host.

### How should I run or update Octofree in Docker?

Run the latest published image with your env file and a mounted data folder, or build locally if you need to modify the code.

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