> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/capstorm-container/installation-instructions.md).

# 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:

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-990cac67e624c3b7b241ae06d461b64f23b96042%2Fc63e0545-Screenshot-2024-01-09-at-9.51.11-AM.png?alt=media)

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:

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-7c3ba5bfd28e71f59157c3ba6aa35352a8431aab%2F8d038795-image30-300x95.png?alt=media)

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

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-c52c1f0477dc586bb2a0d03aebce5ffd79ab4ca0%2Fd3327230-Screenshot-2024-01-09-at-10.20.21-AM.png?alt=media)

## 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.

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-03e488683dfd2f82c2f1904eeee0f6310a63699d%2F8c768e49-Screenshot-2024-01-09-at-10.23.47-AM.png?alt=media)

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

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

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-69dae2ca1e9c9aa9051e5aa5f935bd93c525935d%2F174cd9cc-Screenshot-2024-01-09-at-10.26.39-AM.png?alt=media)

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

![](https://495509274-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDAPx1zE2IARmzGMaHbAx%2Fuploads%2Fgit-blob-fcb1b4bb1dce8cd4b5c6b7ce00b4972e61f66ede%2Ff8beff3e-image22-300x254.png?alt=media)