# Installation Instructions

To install the CapStorm/Container, you will need to have a container host ready to run the container.

This installation guide provides an example installation path using the Docker Desktop application.

## 1: Launch the container

1. Pull the latest image from the **capstorm/capstorm** docker repository.
2. Configure port forwarding to enable web access. CapStorm/Container web services are hosted via Apache Tomcat, which consumes the following ports:
   1. Container port 8080 provides HTTP access.
   2. Container port 8443 provides self-signed HTTPS access.
3. Start the container.
4. Navigate to the container’s web URL (<http://localhost:8080>).

If the image has successfully launched, you will see a screen that looks like this:

![](/files/Ss3bDF3fTiEgqJNhZ6iz)

Once the container is launched, log in with the following credentials:

* Username: **capstorm**
* Password: **capstorm**

## 2: Provide Initialization Parameters

To configure initial container parameters, click on the *Click Here for Initial Configuration* link:

![](/files/ZTSzboRwsYS8rAH5PkXi)

After Clicking the *Click Here for Initial Configuration* link, you will see a screen that looks like this:

![](/files/iu7epWsMUU1msI9rI4ev)

## Initialization Parameters

| Parameter                                                                                                                                 | Required | Description                                                                                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Customer Key                                                                                                                              | yes      | CapStorm-provided identifier, used for licensing.                                                                                                                                                                        |
| Admin Password                                                                                                                            | yes      | The password for the “Admin” username. After initializing, the “CapStorm” user is no longer available and the “Admin” username will be used.                                                                             |
| <p>Third-party Authentication:</p><ul><li>Salesforce Username</li><li>Authenticator URL</li><li>Client Id</li><li>Client Secret</li></ul> | no       | Use these parameters to authenticate with the CapStorm/Portal using a Salesforce username and password.                                                                                                                  |
| Connection String                                                                                                                         | yes      | JDBC Connection String used to connect to the CapStorm/Portal configuration database. For initial configuration, this should point to an empty schema – the CapStorm/Portal will bootstrap all required schema elements. |
| JDBC Driver                                                                                                                               | yes      | JDBC driver used to connect to the CapStorm/Portal configuration database.                                                                                                                                               |
| Username                                                                                                                                  | yes      | JDBC username used to connect to the CapStorm/Portal configuration database.                                                                                                                                             |
| Password                                                                                                                                  | yes      | JDBC password used to connect to the CapStorm/Portal configuration database.                                                                                                                                             |

When initialization parameters have been provided, click *Validate Configuration* to validate the provided customer key & database connection.

![](/files/NZY2H7I3QbDP2fkFb15T)

## 3: Click *Save Configuration* & start using CapStorm!

After a successful save you’ll see the following dialog:

![](/files/6z07FKzEYSXpm0YFgpXY)

Refer to the comprehensive [CapStorm/Container Reference documentation](/capstorm-container/reference.md) for in-depth insights into various components of the web application.

![](/files/kBgSLR3gXcUz7JkQ7XdG)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/capstorm-container/installation-instructions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.