Frequently Asked Questions

Clear answers regarding VPS coexistence, Redis key isolation, performance safeguards, and telemetry.

Infrastructure & VPS
#vps #nginx #port

Will PulseSocketDB interfere with existing projects on my VPS?

No. PulseSocketDB is designed with complete isolation: • Dedicated Port: Runs on port 3001 by default, avoiding conflicts with other local apps (ports 3000, 8080, etc). • Nginx Domain Routing: Nginx forwards requests based on hostnames (e.g. api.pulsesocketdb.com). • Isolated Processes: Each process runs under PM2/Docker. A restart in one app does not affect others.
Infrastructure & VPS
#vps #hardware #ram

What are the minimum and recommended VPS hardware requirements?

• Minimum (Testing / Small Apps): 1 vCPU, 1 GB RAM, 10 GB SSD. Handles tens of thousands of requests alongside lightweight apps. • Recommended (Scale Production): 2 vCPUs, 4 GB RAM, 40 GB NVMe SSD. Delivers sub-millisecond RAM caching and thousands of concurrent WebSockets.
Redis & Isolation
#redis #namespace #keys

Is Redis per-project or global? How are key collisions prevented?

PulseSocketDB prevents collisions through two key mechanisms: 1. Prefixed Namespaces: All internal keys use structured prefixes (e.g. project_meta:*, user_redis_config:*, quota:*). 2. Logical Databases (DB Index): Set REDIS_URL to target dedicated databases (e.g. redis://127.0.0.1:6379/1), isolating data from default db 0.
Redis & Isolation
#byo redis #custom redis #aws

Can clients connect their own Redis instance (BYO Redis)?

Yes! PulseSocketDB includes a dynamic TenantConnectionManager. Pro and Enterprise clients can supply custom Redis endpoints (AWS ElastiCache, Upstash, Redis Enterprise) for 100% data sovereignty.
Performance & Limits
#maxmemory #ram #performance

How do I cap Redis memory usage to safeguard my VPS?

In /etc/redis/redis.conf, configure maxmemory and maxmemory-policy: maxmemory 512mb maxmemory-policy noeviction This sets a strict memory cap so Redis never starves the host operating system or adjacent applications.
Performance & Limits
#fastify #node.js #latency

What is the average resource footprint of the Core API?

The Fastify-powered Core API is ultra-lightweight: • RAM Usage: ~100MB to 150MB at idle. • Latency: Sub-5ms in-memory operations. • PM2 Protection: Recommended launch flag --max-memory-restart 500M ensures automatic preventive recovery.
Consumption & Metrics
#metrics #dashboard #usage

How can clients track resource usage and billing metrics?

PulseSocketDB provides live telemetry inside the Dashboard: • Total Operations: Granular tracking of Reads and Writes. • Storage Volume: Exact memory usage in MB/KB. • Active Connections: Number of live WebSocket subscribers. • Quota Status: Visual alerts when approaching tier thresholds.
Consumption & Metrics
#quota #rate limit #429

What happens when a plan quota is exceeded?

When a quota limit is reached, excess requests return a 429 Too Many Requests response. Saved data remains 100% safe, and instant plan upgrades can be triggered from the Dashboard.
SDK & WebSockets
#sdk #npm #privacy

Does publishing the npm SDK expose my private repository?

No! The npm package (pulsesocketdb) publishes only the compiled dist/ directory specified in package.json ("files": ["dist"]). Your GitHub monorepo remains completely private.
SDK & WebSockets
#sdk #websocket #reconnect

How does the SDK handle temporary connection drops?

The SDK features automatic reconnection with Exponential Backoff. If a WebSocket connection drops due to network blips, it reconnects seamlessly in the background without UI blocking.
Architecture & Scalability
#connections #redis #scalability

The system writes data to the database. Will that overwhelm Redis with thousands of simultaneous connections?

No — and this is one of PulseSocketDB's most important architectural advantages. The system uses a connection multiplexing model: regardless of how many clients are connected simultaneously (100, 1,000 or 10,000), Redis always receives only 2 fixed connections from the Core API: • 1 command connection (reads and writes) • 1 Pub/Sub connection (real-time event broadcasting) Clients connect to Node.js via WebSocket. Node.js acts as an efficient intermediary — Redis is never exposed directly to end-user count. This is the same architecture used by Firebase Realtime Database and Supabase Realtime, products that serve millions of users on Redis.
Architecture & Scalability
#redis #sql #postgres

Can Redis handle many simultaneous writes? Isn't it the same problem as SQL databases that lock under high concurrency?

Redis and SQL databases have fundamentally different models: • PostgreSQL / MySQL: Each client opens 1 dedicated connection to the database. 500 simultaneous users = 500 connections — a real bottleneck requiring connection pools and replica sets. • Redis: Single-threaded event loop. Processes 100,000+ operations per second in RAM on a single instance, with zero locking. Writing a document is an atomic HSET operation taking under 1 millisecond. The concern about 'database not supporting simultaneous writes' is valid for SQL systems, but does not apply to Redis, which was specifically designed for high-throughput, write-heavy workloads.
Architecture & Scalability
#redis #sql #postgresql

Why use Redis as the primary database instead of PostgreSQL?

PulseSocketDB was built for a specific use case: real-time data with ultra-low latency. Redis is the ideal choice because: • Speed: Sub-1ms in-memory operations (vs. tens of milliseconds on disk with SQL). • Native Pub/Sub: Redis has a built-in publish/subscribe system — the foundation of our real-time sync, with no polling or external triggers needed. • Rich Data Structures: Native Hashes, Sets, and Sorted Sets handle operations that would require complex SQL queries. • Schema-free: Perfect for dynamic data varying by project and client. For data requiring SQL (complex reports, joins, multi-table ACID transactions), PulseSocketDB is not the right tool — and we are honest about that. Our focus is real-time state sync, not replacing transactional databases.

Still have technical questions?

Check our full production deploy guide or explore the API reference documentation.