Nametag

⚠️ Active Development Notice

Nametag is under active development and may introduce breaking changes between releases. Please read the release notes carefully before updating to ensure a smooth upgrade process.

Nametag is a personal relationships manager that helps you remember the people in your life and how they're connected. Track birthdays, contact information, how people are connected, and visualize your network as an interactive graph.

Dashboard with network overview and statistics

Try the hosted version →

Screenshots

View screenshots

Main dashboard with a network graph of relationships

---

People list page

---

Groups page

---

Journal page

---

Relationships page

Features

• Track people with flexible attributes (name, birthday, important dates, photos, and user-defined custom fields)
• Map relationships between people with custom relationship types
• Visualize your network with interactive force-directed graphs
• Organize contacts into custom groups
• Interactive map view with geocoded addresses and clustered markers
• Journal for logging interactions and notes over time
• Set reminders for important dates and staying in touch
• CardDAV sync with Google Contacts, iCloud, Outlook, and Nextcloud
• vCard and JSON import/export
• Duplicate detection and contact merging
• Global fuzzy search with accent-insensitive matching
• REST API with OpenAPI documentation and token authentication
• OIDC / SSO authentication support
• Installable as a PWA
• Trash with soft-delete and restore
• Bulk operations (delete, group assignment, relationships)
• Messaging app quick links (WhatsApp, Signal, Telegram, and more)
• Full dark and light theme support
• Multiple languages (English, Spanish, Japanese, Norwegian, German, Chinese, Italian, Russian, Dutch)
• Mobile-responsive design
• Multi-platform Docker support (AMD64 and ARM64)

Hosted vs Self-Hosted

We offer a hosted version at nametag.one with a generous free tier and affordable paid plans, which helps fund development. You can also self-host Nametag for free with unlimited contacts and complete data ownership.

See the installation guide in the docs to get started with self-hosting.

Quick Start (Self-Hosted)

mkdir nametag && cd nametag
# add a docker-compose.yml and .env file (see the installation guide)
docker compose up -d

Then visit http://localhost:3000. For the full installation guide, environment variables, email, OIDC, Redis, and reverse proxy setup, see the docs.

Read the full docs →

Contributing

We welcome contributions! See CONTRIBUTING.md for how to get involved, and the development setup guide for detailed instructions on running Nametag locally.

Roadmap

ℹ️ Contributions to any of these items are very welcome! Items that require the most help will have the [HELP NEEDED] tag. If you want to contribute to an item that does not have a PR or Issue associated to it, please create it yoursef.

To do

Future features and improvements, ordered by priority:

• [HELP NEEDED] Mobile app (Native apps for Android and iOS are preferred)
• Add support for SQLite databases
• Add notification support [Issue #6]
• Support multi-user groups [Issue #37]
• Immich integration [Issue #46]
• [HELP NEEDED] Additional language translations (Portuguese, Korean, etc.)

Done

Features and improvements that have already been implemented:

• UI/UX improvements and accessibility enhancements
• Documentation improvements (API, deployment, functionality, development, etc)
• SMTP support [Issue #4, PR #21]
• Option to disable registration [Issue #9, PR #17]
• ARM build for docker images [Issue #14, PR #18]
• Improve development setup to make contributors' lives easier [PR #25]
• Implement CardDAV support [Issue #15, PR #82]
• API for third-party integrations [Issue #29, PR #70]
• Add photos to people [Issue #19, PR #135]
• Add custom template titles for important dates [Issue #23, PR #176]
• Add journaling capabilities [Issue #28, PR #192]
• Implement OIDC [Issue #10]
• Add map to show people's locations [Issue #26, PR #341]
• Full-text fuzzy search [PR #301]
• Configurable photo compression [PR #331]
• HEIC photo support [PR #357]
• Messaging app quick links [PR #375]
• PWA / installable app with offline support [PR #379]
• Duplicate detection and contact merging
• Custom field templates
• Trash with soft-delete and restore
• Data import/export (JSON)
• Bulk operations
• Eastern name order support

License

Licensed under the GNU Affero General Public License v3.0. This ensures that if you modify and deploy Nametag, you must make your source code available.

Support

• Hosted version: For support with the hosted service, email support@nametag.one
• Self-hosting: Open an issue on GitHub, or check the docs
• Security issues: See SECURITY.md

Support Development

If you find Nametag useful and want to support its development, you can buy me a coffee! ☕

---

Built with care for people who care about people.