Introduction
Parse Server is the open-source backend framework that succeeded the original Parse platform acquired by Facebook. It gives mobile and web developers a full-featured BaaS they can run on their own servers, removing vendor lock-in while keeping a familiar SDK-driven workflow.
What Parse Server Does
- Exposes REST and GraphQL APIs for CRUD operations on arbitrary data classes
- Handles user signup, login, sessions, and role-based ACLs out of the box
- Sends push notifications to iOS, Android, and web clients via adapters
- Runs server-side Cloud Code functions and triggers (beforeSave, afterDelete, etc.)
- Stores and serves files through pluggable adapters (local disk, S3, GCS)
Architecture Overview
Parse Server is a Node.js/Express application that sits between your client SDKs and a MongoDB or PostgreSQL database. Incoming requests hit the REST or GraphQL router, pass through middleware for authentication and rate limiting, then reach the database adapter. Cloud Code hooks run in the same Node process, and a LiveQuery server can be enabled for real-time subscriptions over WebSockets.
Self-Hosting & Configuration
- Install via npm:
npm install parse-server - Requires Node.js 18+ and MongoDB 5+ or PostgreSQL 13+
- Configure with environment variables or a JSON config file (appId, masterKey, databaseURI)
- Deploy behind Nginx or Caddy with HTTPS termination
- Optional Parse Dashboard provides a web-based admin panel
Key Features
- Multi-tenant support with multiple applications on one server
- LiveQuery for real-time data sync without polling
- Pluggable auth adapters for OAuth providers (Google, Apple, GitHub)
- Schema enforcement and migration tooling for structured data
- Horizontal scaling via stateless Node processes behind a load balancer
Comparison with Similar Tools
- Firebase — managed and proprietary; Parse Server is self-hosted and open
- Supabase — PostgreSQL-first with row-level security; Parse uses its own ACL model
- Appwrite — newer BaaS with built-in functions runtime; Parse has a larger ecosystem
- Directus — database-first headless CMS; Parse provides richer SDK integration
FAQ
Q: Can I migrate from the original Parse.com? A: Yes. Parse Server was designed as a drop-in replacement; export your data and point your SDKs at the new URL.
Q: Does it support PostgreSQL? A: Yes. The Postgres adapter is production-ready since Parse Server 2.x.
Q: How do I handle background jobs? A: Use Cloud Jobs scheduled via parse-server-job-scheduler or an external cron.
Q: Is there a hosted option if I do not want to self-host? A: Several providers (Back4App, AWS Amplify with Parse) offer managed Parse Server hosting.