Grid Guides

Explore How System On Grid Can Work For You

Grid Guide Topics

CouchDB One-Click App Setup


One of the many available One-Click Apps that we have is CouchDB.CouchDB is one of what many are calling NoSQL solutions. Specifically, CouchDB is a document-oriented database and within each document fields are stored as key-value maps. Fields can be either a simple key/value pair, list, or map.


  • Orbit created with CouchDB image

  • Running Orbit

Creating Your Orbit

  1. To create your application, you must create a Photon. You can do so by selecting the Photon tab after selecting ‘Create Orbit’


  2. Once there, you will see a list of available photons that you can create. Select one and it will bring you to a detailed page

    Photon List Photon Description

  3. Scroll down to the details and you can start selecting options for your photon as well as setting up credentials.

    Photon Details

  4. Once everything is filled in, just press Create and you can move on to the next step

SSH into Orbit

  1. First we need to check some details on our orbit by first navigating to the “My Orbits” tab.

    My Orbits

  2. Once there, click on the Orbit you want to connect to and check for three things:

    • IP Address

    • Running Status

    • Source Image(Ubuntu, Debian, Centos, Fedora

    Orbit Details

  3. Once you have confirmed that your Orbit is running and you have the other information. Open up your console.

  4. Now you can SSH into your Orbit by running.

    ssh image@address
    • IP Address: We got this from the detail page, in this case it is “”

    • Image: We got this from the source image in the details page. It should be one of the following: ubuntu, debian, fedora, centos

    • Note: A full command for this example would be: “ssh ubuntu@”

Starting CouchDB

  1. Once you are SSH’d into the server you will see the following.

    CouchDB CMD

    All passwords are generated when an orbit is first created and stored in a .secrets file, unless the welcome screen says otherwise. To access it, run the following command:

     cat .secrets
  2. First let’s check if the service is running.

    docker ps 

    CouchDB Docker

  3. Now that everything is running we can go to the website. Type the IP Address followed by the port ‘5984/_utils’. You should see a page like the following:

    CouchDB Dashboard

  4. In the bottom right you need to log in with the admin account whose username is ‘admin’ and password is ‘password’:

    CouchDB Admin

  5. After you are logged in you can create a new database from the top left part of the dashboard.

    CouchDB Database

  6. Now that you have your database created, you are ready to go for your application.