Table of Contents
This guide will help you run a local development setup that sets up both, Space Cloud and MongoDB. It will help you explore the Space Cloud APIs on MongoDB without having to set up any client side projects.
Note: MongoDB is not a dependency of Space Cloud. We are using MongoDB in this guide for ease of use because of it’s schemaless nature.
The spaceuptech/space-cloud/install-manifests repo contains all installation manifests required to deploy Space Cloud anywhere. Get the docker compose file from there:
docker-compose up -d
Check if the containers are running:
exec into docker container of Space Cloud, you can see a
config.yaml file and a
raft-store folder would have been generated in the home directory.
Space Cloud needs this config file in order to function. The config file is used to load information like the database to be used, its connection string, security rules, etc.
Space Cloud has it’s own Mission Control (admin UI) to configure all of this in an easy way.
Note: All changes to the config of Space Cloud has to be done through the Mission Control only. Changes made manually to the config file will get overwritten.
Head over to
http://localhost:4122/mission-control to open Mission Control.
localhostwith the address of your Space Cloud if you are not running it locally.
Create a Project button.
name to your project. MongoDB will be selected as your database by default. Keep it as it is for this guide.
Next to create the project. On creation of project you will be directed to the project overview screen.
Head over to the
mongodb://mongo:27017 in the
connection string input.
Save button. That’s all what is required to configure Space Cloud for this guide!
Note: If you are using an SQL database, you should hit the
Set Up Databasebutton to create the internal tables which Space Cloud requires after saving the right connection string.
Our backend is up and running, configured to expose APIs on MongoDB. Time to explore it’s awesome powers.
Explore GraphQL APIs of Space Cloud using GraphiQL.