Sign inSign up

gallinij/rolodex

By gallinij

•Updated about 21 hours ago

Self-hosted personal relationship manager with contacts, calendar, tasks, and CardDAV/CalDAV sync.

Image
Developer tools
Databases & storage
0

766

gallinij/rolodex repository overview

⁠Rolodex

⁠Your relationships deserve a home of their own.

Rolodex is an open-source, self-hosted Personal Relationship Manager (PRM) that brings your contacts, relationships, calendar, and tasks together in one private platform.

Remember more than names and phone numbers. Keep track of how you met people, important details, shared experiences, and the relationships that matter to you.

Your data stays on your infrastructure. Your devices stay synchronized through open standards.

Website: Rolodex⁠
Source Code: GitHub Repository⁠
License: AGPL-3.0


⁠Features

  • Personal Relationship Management — Organize contacts, relationships, notes, interests, tags, and the history of how you know someone.
  • Calendar & Tasks — Keep your schedule and tasks connected to your personal information.
  • Universal Synchronization — Sync contacts through CardDAV and calendars and tasks through CalDAV.
  • Mobile & Desktop Support — Connect iPhone, iPad, Android, macOS, and compatible desktop applications.
  • Privacy First — Self-host your data and control access to your personal information.
  • Immich Integration — Connect your personal photo library.
  • External Account Integrations — Optionally connect supported external mailboxes and calendars.
  • Account Security — Invite-controlled registration, named synchronization clients, and optional two-factor authentication.
  • Data Portability — PostgreSQL-backed storage with documented backup and restore procedures.

⁠Quick Start

The recommended deployment uses Docker Compose with PostgreSQL.

⁠1. Download the deployment configuration
git clone https://github.com/Rolodex-PRM/rolodex.git
cd rolodex
cp .env.example .env
⁠2. Configure your environment

Before exposing Rolodex to the internet, update the following values in .env:

  • POSTGRES_PASSWORD — Set a strong database password.
  • CREDENTIALS_KEY — Set a secure credentials encryption key.
  • PORT — Set the desired application port if necessary.

Review the environment configuration before starting the application.

⁠3. Start Rolodex
docker compose pull
docker compose up -d
⁠4. Open the application

Navigate to:

http://localhost:8080

The first user to register becomes the administrator.

For complete installation, networking, and configuration instructions, see the installation documentation⁠.


⁠Container Image

Docker Hub: gallinij/rolodex

Pull the latest published image:

docker pull gallinij/rolodex:latest

The repository publishes versioned images alongside the latest tag. The latest tag tracks the current published build.

For reproducible deployments, use a specific version tag rather than relying on latest.


⁠Data Persistence

Rolodex is designed for self-hosted operation.

Persistent application data includes:

  • PostgreSQL database
  • Uploaded files and attachments

Use persistent Docker volumes and maintain regular backups. Rolodex includes backup and restore scripts for its database and uploaded files.

Never remove persistent volumes when upgrading or recreating containers unless you intentionally want to delete your data.


⁠Documentation & Support

⁠Open Source

Rolodex is distributed under the GNU Affero General Public License v3.0.

You can self-host, inspect, modify, and contribute to the project under the terms of its license.

Your people. Your books.

Tag summary

Content type

Image

Digest

sha256:a501a236c…

Size

112.7 MB

Last updated

5 days ago

docker pull gallinij/rolodex