The CodeStream API Service is lovely.

1. Install the dev_tools tookkit here.
2. Install mongo - this is available as a dev_tools sandbox or you can install any version. Instructions for the mongo sandbox are here.
3. Make sure you can access the CodeStream network via the VPN.
4. Review how we manage our server configurations. If you have any custom alterations to the standard configuration, you will need to be familiar with the procedures in this document.

1. If you're using dev_tools on your own computer, bring it up to date (dt-selfupdate -y). You don't need to do this if you're using a managed EC2 instance.
2. Update your secrets (dt-update-secrets -y).
3. Select a codestream configuration to use (details documented here). To get up and running quickly, this command will select out-of-the-box 'codestream-cloud' as your configuration.

   $ echo codestream-cloud > ~/.codestream/config/codestream-cfg-default.local
   

4. Open a new terminal window
5. Choose a name for your mongo sandbox. The default is mongo (which this documentation will assume). Load your dev_tools mongo sandbox if you're using one and start the mongo service.

   $ dt-load mongo
   $ mdb-service start
   

   If using your own mongo installation, make sure it's running and accessible without credentials on localhost (the default mongo connect url is mongodb://localhost/codestream).
6. Install the api sandbox (only specify -I if you are not using or have not loaded a dev_tools mongo sandbox). A default api sandbox name of api is assumed in some tools so we'll use it here (though you can change it):

   dt-sb-new-sandbox -yCD [-I] -t cs_server -n api -O sb.info.api
   

7. Load your api sandbox:

   $ dt-load api
   

8. Create a playground for setting up future terminals with your mongo + api sandboxes. This will create one called api.

   $ dt-sb-create-playground -t $CS_API_TOP/sandbox/playgrounds/default.template
   

9. If you haven't already, install the mailin and mailout sandboxes.
10. Load all of your sandboxes into one shell and create a cs playground for your codestream-cloud configuration.

    $ dt-load mongo
    $ dt-load api
    $ dt-load mailin
    $ dt-load mailout
    $ dt-sb-create-playground -t $CS_API_TOP/sandbox/playgrounds/cloud-dev.template
    

• To setup a new terminal's environment for the API

  $ dt-load-playground api [--start | --stop]
  

  optional --start will load the sandboxes and start the services.

  optional --stop will load the sandboxes and shutdown the services.

• To control the mongo service (if mongo is a sandbox):

   $ mdb-service
  

• To run the API in the foreground with one worker:

   $ cd $CS_API_TOP
   $ bin/ensure-indexes.js
   $ bin/api_server.js --one_worker
  

• To control the api service using the init script

   $ cs_api-service
  

• To see the api sandbox commands

   $ cs_api-help
  

• To see the api sandbox environment variables

   $ cs_api-vars
  

• To run the api_server with a debugger, add an --inspect argument before the executable .js file as such:

   node --inspect bin/api_server.js --one_worker
  

  or

   nodemon -e js,hbs --inspect bin/api_server.js --one_worker
  

  Then, in VS Code, run the Node: Debugger task. You'll want to attach to the process running on port 9230 when prompted.

The unified configuration file
OnPrem development configuration