rolodex

your people. your books.

Your people. Your books. On a server you run.

A self-hosted relationship manager for the people you know — with the history, calendar, and tasks that travel to your phone.

Features

One place for the people you keep.

Rolodex holds the address book, the calendar, the tasks, and the story of how you know someone — then syncs a clean copy to every device that speaks CardDAV or CalDAV. Share people with the household, and collaborate without handing over the whole book.

  • People with memory How you met, interests, tags, and private notes stay in Rolodex. The card note syncs to the phone.
  • Share & collaborate Invite others into the workspace. Share a person with a group for view or edit access, so assistants, partners, and teammates keep the same record.
  • Relationships you can see Named ties on both sides, households, and a network map that shows who connects to whom.
  • Reach-out that respects you Home suggests who to get back in touch with, on a cadence you choose per person.
Rolodex contacts list with the new brand mark

Shared contacts

Put a person in a user group with View or Edit. Several accounts can keep one shared record without cloning cards.

Workspace roles

Owner, Administrator, Editor, Contributor, and Viewer decide who can change people, events, and tasks.

Calendar & tasks

Events and to-dos live beside the people they belong to. CalDAV keeps phones and desktops in step.

Named sync clients

Each phone gets its own client password and last check-in. The website password never goes on the device.

Invite-only by default

The first visit creates the administrator. Registration stays invite-only until you open it under Admin → Security.

Second factor

Optional authenticator apps or emailed codes once notifications are turned on.

Immich & outside mail

Link Immich faces to contacts. Optionally pull an outside mailbox or calendar. Both stay off until you enable them.

MCP Server

Enable the add-on and point an AI client at /mcp for read-only contacts, relationships, and interactions.

Trash with retention

Deleted people sit in Trash until restored or the retention window ends — then the next sync catches up.

Compare

Where Rolodex sits.

Clay (now Mesh) captures a wide automatic timeline in the cloud. Monica is the classic open-source personal CRM. Rolodex is built for self-hosters who want phone sync and a living network on their own machine.

Capability Rolodex Clay / Mesh Monica
Hosting model Self-hosted on your server Hosted SaaS Self-host or hosted
License AGPL-3.0 Proprietary AGPL
Phone address book CardDAV Native apps & imports Web-first (community clients)
Calendar & tasks CalDAV on the same origin Calendar import / sync Reminders & activities
Relationship graph Named ties + network map Timeline & enrichment Family & relationship links
Share & collaborate Workspace roles + per-person groups (view/edit) Team plans / shared intros Multi-user on a shared instance
Data capture style Deliberate records + optional mail/calendar check-in Automatic capture from many accounts Mostly manual, by design
Photos Immich links (optional) In-app media Contact photos / attachments
Cost to run yourself Your hardware only Subscription Your hardware only

Clay rebranded as Mesh. Feature sets move; this table reflects the usual product shapes as of late 2026: cloud automation versus open-source personal CRM versus Rolodex’s self-hosted sync-first approach.

Install

Two containers. One port.

Postgres and Rolodex. The published image is gallinij/rolodex:latest (built when a GitHub Release is published). That single HTTP port is the website, /api/, CardDAV, and CalDAV. Copy .env.example to .env, then pull or build.

cp .env.example .env
docker compose pull
docker compose up -d
01

Open the site

Visit http://localhost:8080, or your machine’s LAN address on the same port. Change PORT in .env if 8080 is taken.

02

Create the admin

The first visit creates the administrator. Later accounts stay invite-only until you turn open registration on.

03

Point phones at it

Use the same address you opened. On a domain, put a reverse proxy or Cloudflare tunnel in front and open the site once so Settings picks up HTTPS.

Configure

Environment variables

Everything lives in .env next to docker-compose.yml. Compose injects the database URL and data directory for the Rolodex service. Replace the sample secrets before the machine is reachable by anyone else.

Required for Docker

Set these before docker compose up on a shared or public host.

Variable Default What it does
ROLODEX_IMAGE gallinij/rolodex:latest Image Compose pulls. Use a version tag for pinned upgrades, or build from this repository instead.
PORT 8080 One public HTTP port: website, /api, /carddav, and /caldav. TLS belongs to your proxy or tunnel.
POSTGRES_USER rolodex Postgres role name. Compose builds DATABASE_URL from this, the password, and the database name.
POSTGRES_PASSWORD rolodex Postgres password. Change it before exposure. If the volume already exists, update .env and Postgres together.
POSTGRES_DB rolodex Database name created on first boot.
CREDENTIALS_KEY sample local key 32-byte base64 secret for encrypted credentials. Generate a new one for production.

Public URL & ports

Most installs only need PORT. Set a public URL when phones should not use the browser origin.

Variable Default What it does
PUBLIC_URL unset Public site origin when phones use a tunnel or DNS name, for example https://rolodex.example.com. Leave unset when the browser address is already correct.
POSTGRES_PORT 5472 Host port for Postgres on 127.0.0.1 — for backups and local tools. Inside Compose, Postgres still listens on 5432.
API_PORT 4100 Local pnpm dev only. Docker keeps the API on an internal port behind the gateway.
CARDDAV_PORT 4101 Local pnpm dev sync port. Docker serves CardDAV/CalDAV on PORT instead.
WEB_DEV_PORT 4181 Expo web dev server port. Unused by Docker.
S3_PORT / S3_CONSOLE_PORT 9100 / 9101 MinIO ports when you start the optional s3 Compose profile for local development.

HTTP & development

These matter for pnpm on your machine. Docker reads the browser origin unless you set PUBLIC_URL.

Variable Default What it does
DATABASE_URL localhost Postgres URL Connection string for local processes. Docker overrides this to talk to the postgres service.
PUBLIC_APP_URL http://localhost:4181 App origin during local development.
CORS_ORIGIN local web ports Browser origins allowed to call the API with cookies in development.
COOKIE_SECURE false Set true when a local API is reached over HTTPS. Docker follows the forwarded protocol instead.
EXPO_PUBLIC_API_URL http://localhost:4100 Dev server only. The Docker site calls /api on the same host.
PUBLIC_CARDDAV_URL http://localhost:4101 Direct CardDAV URL for local sync testing. Public Docker installs use /carddav and /caldav on PORT.
PLUGINS_DIR unset Extra plugin folders. The project plugins/ directory and DATA_DIR/plugins are always read.

Storage, backups & maps

Docker stores uploads on the uploads volume unless you point it at S3. Map keys are optional.

Variable Default What it does
DOCKER_S3_ENDPOINT unset When set, Docker uses this S3 endpoint instead of the uploads volume. Compose maps it onto S3_ENDPOINT inside the container.
S3_ENDPOINT http://127.0.0.1:9100 S3-compatible endpoint for pnpm development. Start MinIO with docker compose --profile s3 up minio -d.
S3_REGION us-east-1 S3 region string passed to the client.
S3_ACCESS_KEY / S3_SECRET_KEY sample keys Credentials for MinIO or another S3 store. Also seed the optional MinIO service.
S3_BUCKET rolodex Bucket name for uploaded files when S3 is in use.
BACKUP_DIR ./backups Where scripts/backup.sh writes dumps and upload archives on the host.
GOOGLE_MAPS_API_KEY blank Optional. Leave blank for OpenStreetMap. Can also be saved under Admin → Map.
MAPBOX_ACCESS_TOKEN blank Optional Mapbox token. Same Admin page can store it later.

Generate a credentials key with node -e "console.log(require('crypto').randomBytes(32).toString('base64'))". After any port change, run docker compose up -d again.

Rolodex sign-in screen

Sync

What reaches a phone.

Create a named client password under Settings. Sign in with your email and that client password — never the website password.

  • iPhone & iPad — CardDAV account plus a separate CalDAV account.
  • Android — DAVx5 against the base URL.
  • Mac — Internet Accounts.
  • Desktop — Thunderbird and any CardDAV / CalDAV client.
  • On the wire — name, phones, emails, address, birthday, and the card note.
  • Stays in Rolodex — how you met, interests, tags, private notes, and the network.

Ownership

Your server. Your copies.

Uploaded files live in the uploads volume. Backups are a Postgres dump plus a tar of uploads. An owner can also download a database dump from Settings when pg_dump is available.

OpenID ready

Administrators can offer Authentik, Authelia, Keycloak, or another OpenID provider. Password sign-in stays available.

Share without cloning

Workspace roles for the household, and groups so one contact can be shared for view or edit across several accounts.

AGPL-3.0

Read the code, run it yourself, and keep modifications that you offer as a network service available to the people using them.