# Getting Started

Sigma Config is a centralized configuration management hub that allows you to share values across your organization's applications and environments. Parameters and secrets can be created and stored directly within Sigma, or referenced from external sources, such as AWS SSM, Secrets Manager and S3. Unique parameter and secret values can be set for specific environments such as development, staging and production.

Get started by creating a Sigma Config account, create your first parameters and Install the CLI to start accessing parameters across environments!

{% content-ref url="org-management/account-setup" %}
[account-setup](https://docs.cloudtruth.com/org-management/account-setup)
{% endcontent-ref %}

{% content-ref url="configuration-management/parameters" %}
[parameters](https://docs.cloudtruth.com/configuration-management/parameters)
{% endcontent-ref %}

{% content-ref url="configuration-management/cli-and-api/cloudtruth-cli" %}
[cloudtruth-cli](https://docs.cloudtruth.com/configuration-management/cli-and-api/cloudtruth-cli)
{% endcontent-ref %}

## **QuickStart Guide**

### **Create a CloudTruth account**

Create your CloudTruth account by navigating to the portal at [https://app.cloudtruth.io](https://app.cloudtruth.io/)

You can choose to create a new login with CloudTruth or use an existing social login with a GitHub, Google or Microsoft account.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-fd375e443f5010273f3b17f0264d6c0330951269%2Fimage%20\(261\).png?alt=media)

You will be taken to the CloudTruth application where you will create an Organization. This is your own private space for creating and managing configurations.

### Create an Organization

Enter a name for your organization, accept the [terms of service](https://cloudtruth.com/terms-of-service/) and click "Begin Free Trial". Don't worry, you can edit your organization name later.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-b0e9aff999c97fcf3cf3d3bf57a15e0499bcb241%2FPrtScr%20capture_3%20\(13\).jpg?alt=media)

###

### Create your first Parameters

From the Dashboard click `Add Parameter or Secret` to create a new parameter in `MyFirstProject`.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-d92d6616a80a6de1b477dca3326c59e68a838e7e%2Fimage%20\(255\).png?alt=media)

Provide the key with a name and click `Create Parameter`.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-4c353b9bdb151cbb32622ac4a4cef23bfb6f8dbe%2Fimage%20\(244\).png?alt=media)

Enter an Internal value for the parameter and click `Save`.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-79b7210225700d2c87d7095cc6556df91a031371%2Fimage%20\(258\).png?alt=media)

Repeat this process to add additional parameters or secrets.

### Create an API Access token

Open the CloudTruth API administration screen by clicking `API Access` in the left hand menu.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-81cfb41bf8af4d2beeb473a419b81a249fadb0cd%2Fimage%20\(245\).png?alt=media)

\
Click `Generate New Token`, provide a Token Name\*\*,\*\* [viewer permissions](https://docs.cloudtruth.com/org-management/access-control/user-directory#role-permissions) and click `Generate Token`.

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-5879ff6610d2927ce46a6015ef10cc69203a1af9%2Fimage%20\(108\).png?alt=media)

{% hint style="warning" %}
Copy your access token now and secure it in a safe place. The token is only available at initial creation and will need to be regenerated if it is lost.
{% endhint %}

![](https://2952342643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGjN2Xg1mE8iTvg49dw%2Fuploads%2Fgit-blob-7d8e588f8f88a300d409de24a027a5a5ee1d589d%2FScreenshot%202022-01-11%20093517.png?alt=media)

### Access Parameters with CloudTruth Run

Install the [CloudTruth CLI](https://docs.cloudtruth.com/configuration-management/cli-and-api/cloudtruth-cli) for your distribution and set the API access token in your environment.

{% tabs %}
{% tab title="Shell Install" %}
The shell installer supports Linux and Darwin distros and will install the latest version.

```
(curl -sL https://github.com/cloudtruth/cloudtruth-cli/releases/latest/download/install.sh || wget -qO- https://github.com/cloudtruth/cloudtruth-cli/releases/latest/download/install.sh) | sudo sh
```

Login with the CLI to create and set your [API Access token](https://docs.cloudtruth.com/org-management/access-control/access-tokens)

```
cloudtruth login

=========================
  Use a browser to generate a new API token from the "API Access" page
  (https://app.cloudtruth.io/organization/api).

Open the "API Access" page? (Y/n) Y

Enter the new "API key" here:
"YOUR_API_KEY"
```

{% endtab %}
{% endtabs %}

The CloudTruth run command will passthrough parameters into your environment. You can now see the parameters you created in your CloudTruth organization.

```
cloudtruth --project MyFirstProject run  --inherit none --command printenv
```

Use CloudTruth run to get the value for a specific parameter that is sourced to your environment.

```
cloudtruth --project MyFirstProject run --command 'echo $YOUR_PARAMETER_KEY'
```


---

# 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://docs.cloudtruth.com/getting-started.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.