Local environment
The Back4app local development environment allows you to build and test apps locally using its core features, such as Database, Cloud Functions, Files, Authentication, and Web Hosting. This setup consists of the open-source Parse Server, Parse Dashboard, and a locally installed database, enabling you to prototype and iterate quickly.
This setup is ideal for prototyping, development, and continuous integration workflows.
Set up a local development environment with Back4app.
For a more detailed explanation, you can watch the tutorial video: Back4app Local Setup Guide.
Follow the steps to connect an existing app to your local machine or create a new one. See the CLI guide: Parse CLI Documentation
The easiest way to install Parse Server locally is by using NPM. Run the following command in your terminal:
After installation, start the database so Parse Server can store data:
Go to your Back4app dashboard and copy the APPLICATION_ID, CLIENT_KEY, and MASTER_KEY from Dashboard > App Settings > Security & Keys. Use these values to start your Parse Server:
To improve your development experience, install the Parse Dashboard for a user-friendly interface:
Use the same credentials from the previous step and run the following command to start the dashboard:
If the Parse Dashboard fails to load, replace the URL http://0.0.0.0:4040/ with http://localhost:4040/.
By default, the main server URL for Back4app is https://parseapi.back4app.com. However, for your local instance, you need to update your app's code to point to http://localhost:1337/parse.
- Common Dashboard Errors: If you cannot access the Parse Dashboard locally, ensure you are using the correct localhost URL.
- Database Issues: Ensure the mongodb-runner service is running properly before starting the Parse Server.
With your local Parse Server and Parse Dashboard set up, you now have a fully functional environment for developing and testing your Back4app applications. This local setup allows you to prototype new features, debug issues, and create apps faster without relying on a live environment.