Connecting to your own ODK Aggregate Server

Before you get started…

You need to install ODK Aggregate before you can connect to it.

When connecting to an ODK Aggregate server from Collect, you will need a username and password from your Aggregate server. This can be the superuser created when you install Aggregate, or another user account created by you.

  1. From the Action Button (), select General Settings

    The Main Menu screen of the Collect app. The three-dot 'kebab' menu in the upper-right corner is circled in red. The Main Menu screen of the Collect App. A modal menu has unrolled in the top-right corner, with the option *About*, *General Settings*, and *Admin Settings*. *General Settings* is circled in red.
  2. Select Server

    The General Settings menu in the Collect app. The options are *Server*, *User Interface*, *Form management*, and *User and device identity*. *Server* is circled in red.
  3. Select Type, and set it to ODK Aggregate

    The Server Settings screen in the Collect app. The first item in the menu is labeled *Type*, and this item is circled in red. The Server Settings screen in the Collect App, as displayed in the previous image. There is now a modal menu labeled *Platform*, with single-select radio buttons for: *ODK Aggregate*, *Google Drive, Google Sheets*, and *Other*. *ODK Aggregate* is selected and circled in red.
  4. Edit ODK Aggregate settings

    The Server Settings screen in the Collect app. Below the *Type* option is a section titled *ODK Aggregate Settings*, with the items labeled *URL*, *Username*, and *Password*. These three items are numbered in red. The Server Settings screen in the Collect app, with a modal overlay titled *Server URL*. There is a single text-entry field with a URL, and buttons labeled OK and CANCEL. The Server Settings screen in the Collect app, with a modal overlay titled *ODK Username.* There is a single text-entry field, and buttons labeled OK and CANCEL. The Server Settings screen in the Collect app, with a modal overlay titled *ODK Password*. There is a single obscured-text field, and buttons for OK and CANCEL.

Connecting to another OpenRosa server app

Any server application that implements the OpenRosa API can be connected to, using the instructions laid out above. You would still choose ODK Aggregate as the server type.

In Server Settings, there is currently a Type option of Other. It is unlikely you will need this option, since any server application will need to implement the same API as ODK Aggregate.

If you think you might need to connect to a non-Aggregate server application, and are having trouble, we encourage you to visit our Support Forum.

The Other option will likely be deprecated in the future, and its use is not recommended.