# BeaverHabits

BeaverHabits is a lightweight, self-hosted habit tracker that lets you log and check off daily habits through a minimal, privacy-focused web interface without any cloud accounts. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/4472/beaverhabits

## Description

BeaverHabits is a lightweight, self-hosted habit tracker that lets you log and check off daily habits through a minimal, privacy-focused web interface without any cloud accounts.

## Platform availability

Available on 1 of 10 platforms: Proxmox.

## Health score

61/100 (Good), based on 5 of 5 factors.
- Maintained: 86 (last commit 5 days ago)
- Popular: 65 (1,865 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 100 (256 MB minimum RAM)
- Security check: 10 (3 serious findings, 10 minor, CI, tests)

## Security check

3 serious findings: Uses anyio 4.14.0, which has a known critical vulnerability; Uses certifi 2026.6.17, which has a known critical vulnerability; Uses pyjwt 2.13.0, which has a known critical vulnerability.
Automated checks on commit 332a453, 24 Oct 2026. Not an audit.

## Links

- Documentation: https://beaverhabits.com
- GitHub: https://github.com/daya0576/beaverhabits
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=beaverhabits
- Official website: https://beaverhabits.com/demo

## Common questions

### Which port should I expose for the BeaverHabits container?

The Docker examples use port 8080, so map your host port to container port 8080.

### Where is BeaverHabits data stored, and what should I back up?

It can store data in a single SQLite database named habits.db in DATABASE mode, or in a local JSON file in USER_DISK mode. The Docker examples keep that data in the mounted ./beaver/ directory under /app/.user/.

### How can I skip authentication for a trusted local user?

Set the TRUSTED_LOCAL_EMAIL environment variable to that user's email address. The compose example describes this as skipping authentication.

### Why might BeaverHabits have permission problems with the mounted volume?

The container starts as nobody, so the host folder must be owned by the same UID as the container user. The compose example sets user 1000:1000 to align ownership.

### Is there a native iOS app for BeaverHabits?

Yes, the repository lists an iOS Native App that is offline-first. It also lists an Apple Shortcut for sharing the app on iPhone.

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