# Using Private Modules

All users in an organization with **Manage Modules** permission can view the Terrakube private registry and use the available providers and modules. 

### Using private modules

Click **Registry** in the main menu. And then click the module you want to use.

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/w9lLI55ertunFHm0T0mK/image.png" alt=""><figcaption></figcaption></figure>

In the module page, select the version in the dropdown list

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/lTCw5N5OTRZLGyvjb1ON/image.png" alt=""><figcaption></figcaption></figure>

You can copy the code reference from the module page

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/9nOFE7gDBpxgHlLGuEGz/image.png" alt=""><figcaption></figcaption></figure>

For example:

```
module "google-network" { 
  source = "8075-azbuilder-terrakube-gmnub6flawx.ws-us89b.gitpod.io/terrakube/google-network/google" 
  version = "v6.0.1" 
  # insert required variables here 
}
```

### **Submodules**

If your repository has submodules, Terrakube will scan the **modules** folder to identify all the submodules. Then, you will see a dropdown list with the submodules in the UI.

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/X1VYKzDkwhiYpM79sFzV/image.png" alt=""><figcaption></figcaption></figure>

To view the readme file, inputs, outputs, resources and other information for any submodule, you can choose the submodule you want.

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/AN4ESBgbJnwCGd2zqvJU/image.png" alt=""><figcaption></figcaption></figure>

You can also copy the details of how to configure any submodule, just like the main module. Example:

```
module "iam" { 
  source = "8075-azbuilder-terrakube-7qovhyoq3u9.ws-eu105.gitpod.io/aws/iam/aws//modules/iam-account" 
  version = "v5.30.0" 
  # insert required variables here 
}
```

In the submodule view you can switch to the differents submodules.

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/4qAEVZteTVxS2lNCakk7/image.png" alt=""><figcaption></figcaption></figure>

Or you can back to the main module with the **Back** button on the top of the page.

<figure><img src="https://content.gitbook.com/content/z07DOLykiAoqb1CSQVQz/blobs/XgtkOFtNJfErMsJY83GI/image.png" alt=""><figcaption></figcaption></figure>

### **Configure Authentication**

When running Terraform on the CLI, you must configure credentials in [.terraformrc or terraform.rc ](https://developer.hashicorp.com/terraform/cli/config/config-file)to access the private modules.&#x20;

For example:

```
credentials "8075-azbuilder-terrakube-gmnub6flawx.ws-us89b.gitpod.io" { 
  # valid user API token:
  token = "xxxxxx.yyyyyy.zzzzzzzzzzzzz"
}
```

To get the API token you can check [api-tokens](https://docs.terrakube.io/2.19.0/user-guide/organizations/api-tokens "mention").

As an alternative you can run the [terraform login](https://developer.hashicorp.com/terraform/cli/commands/login) command to obtain and save an user API token.&#x20;

```
terraform login [terrakube hostname]
```