Repository navigation
Keeper.sh #2330
Description
Activity
github-actions commented
on Sep 29, 2026 on Sep 29, 2026 – with GitHub ActionsContributorMore actionsThe Keeper.sh script is ready for testing:
bash -c "$(curl -fsSL https://github.com/community-scripts/ProxmoxVED/raw/main/ct/keeper.sh)"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 runsystemctl 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
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
This script is in active development and may be unstable, incomplete, or subject to breaking changes. It is not recommended for production use.
Yep. Its better because some links in motd, core and other parts. Script will be migrated now.
A PR has been created for keeper: community-scripts/ProxmoxVE#17659
- added and removed
on Oct 3, 2026 Merged with #17659 in ProxmoxVE
Files deleted with PR #2348
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.