Skip to content
Pricing Download Open app
DocsDevelopersSelf-Hosting

Developers

Self-Hosting Both

You can self-host TapTidy on your own infrastructure using Docker Compose. The self-hosted container stack runs the exact same codebase and backend services as the managed cloud deployment.

Stack Architecture

  • API Backend: Node.js 22 + Express 5 + Prisma ORM.
  • Database: PostgreSQL 16+.
  • Cache & Queues: Redis for BullMQ background workers and Socket.io presence events.
  • Web Frontend: React 18 + Vite PWA.

Hardware Requirements

  • Docker Engine 24+ and Docker Compose v2
  • Minimum 2 CPU cores and 4 GB RAM
  • 20 GB disk space for database volumes and snapshot archives

Quick Start with Docker Compose

  1. Clone the repository and enter the directory.
  2. Copy .env.example to .env and configure your database credentials, APP_URL, and SMTP mail server settings.
  3. Launch the container stack: 
    docker compose -f runtime/newredesign/docker-compose.yml up -d
  4. Navigate to your configured APP_URL (e.g. http://localhost:3000) to initialize your administrator account.

Self-Hosted Considerations

  • Push Notifications: Native FCM push requires configuring your own Firebase project credentials. Android devices can also use WebSocket push sync (De-Googled flavor).
  • Updates: The Android app update checker queries the official TapTidy releases endpoint to ensure mobile clients stay up-to-date even when connecting to self-hosted backends.