Repository navigation
Keeper.sh #2330
Description
Name of the Script
Keeper
Script Type
CT (LXC Container)
Does this script support arm64?
arm64 supported
📋 Script Details
community-scripts/ProxmoxVE#13268
Keeper is a simple & open-source calendar syncing tool. It allows you to pull events from remotely hosted iCal or ICS links, and push them to one or many calendars so the time slots can align across them all.
Activity
github-actions commentedon Sep 29, 2026
The Keeper.sh script is ready for testing:
There is no default account: open the web UI and register one with a username and password. Registration stays open to anyone who can reach port 3000, so keep the container off the public internet or behind an authenticating proxy.
iCal/ICS links and CalDAV accounts (iCloud, Fastmail, Nextcloud, ...) work out of the box. Google Calendar and Outlook need your own OAuth app: put the credentials into GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET and MICROSOFT_CLIENT_ID/MICROSOFT_CLIENT_SECRET in /opt/keeper_data/.env, then run
systemctl restart keeper-api keeper-cron keeper-worker.Google and Microsoft only accept HTTPS redirect URIs on a real domain, so OAuth needs a reverse proxy in front of port 3000. Set BETTER_AUTH_URL and TRUSTED_ORIGINS in /opt/keeper_data/.env to that URL and register <BETTER_AUTH_URL>/api/auth/callback/google, /api/sources/callback/google, /api/auth/callback/microsoft and /api/sources/callback/outlook as redirect URIs.
Web UI (port 3000), API (3001), cron and worker run as keeper-web, keeper-api, keeper-cron and keeper-worker. Database, Redis, secrets and OAuth settings live outside /opt/keeper, which is rebuilt on every update.
Note: This is not in the official repo yet—it's just a dev version! After merging into ProxmoxVE, it will need to be recreated.
Discord testing thread: https://discord.com/channels/1302816934508630047/1554462959290294285
tcarlsen commentedon Oct 1, 2026
Installation and configurations worked flawlessly for me. Looking forward to getting this out so I can start using it properly. thanks @MickLesk
Will I need to delete my lxc and reinstall a new one then it goes out of "testing"? just so I know how must time to dedicate to set it up nicely atm
MickLesk commentedon Oct 3, 2026
Yep. Its better because some links in motd, core and other parts. Script will be migrated now.
github-actions commentedon Oct 3, 2026
A PR has been created for keeper: community-scripts/ProxmoxVE#17659
MickLesk commentedon Oct 3, 2026
Merged with #17659 in ProxmoxVE
github-actions commentedon Oct 3, 2026
Files deleted with PR #2348