> ## Documentation Index
> Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Follow this guide to integrate Portal in your Android app.

Portal provides MPC **wallets** and dApp **connections** for organizations and their users.

To integrate Portal, an organization adds a **client library** to their mobile app and a few **server API endpoints**.

## Installation

Update the dependencies in your `build.gradle` to include the `portal-android` dependency

```groovy theme={null}
// In your app/build.gradle file
...
dependencies {
    ...
    implementation "io.portalhq.android:portal-android:X.X.X"
}
```

## Initializing Portal

After you update your `build.gradle` file, you must sync gradle and you're ready to import Portal into an Activity of your choice.

With the `Portal Android` dependency now installed, we can now create an instance of the `Portal` class. Below is an example of how you can do this. In this example, we're using your app's `MainActivity`.

<Tabs>
  <Tab title="5.x.x">
    ```kotlin theme={null}
    package io.portal.android.app

    import io.portal.android.Portal
    import io.portal.android.storage.cloud.google.GoogleStorage
    import io.portal.android.storage.mobile.Keychain

    class MainActivity : AppCompatActivity() {
        lateinit val portal: Portal

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)

            // Initialize your Portal instance.
            portal = Portal(
                // A Portal client API key. You can obtain one from Portal's REST API.
                apiKey = CLIENT_API_KEY,
                // A map of chainIDs to Gateway URLs (e.g. Infura, Alchemy, etc.)
                rpcConfig = mapOf("eip155:10143" to YOUR_GATEWAY_URL),
                // A boolean to auto-approve transactions.
                autoApprove = true,
                //Optional: Only provide Eth chain id here if you are upgrading from V3 otherwise skip this. This is needed for some legacy code
                legacyEthChainId = 10143
            )

            // Configure Backup with GDrive
            portal.configureGoogleStorage(
              GDriveConfiguration(
                  clientId = YOUR_GDRIVE_CLIENT_ID, // Your Google client id with GDrive access
                  signOutAfterUse = true // Signout Google after backup/recover operation,
                  gDriveBackupOption = GDriveBackupOption.AppDataFolder // this mode specifies where the backup key is stored in GDrive. Will be explained later in GDrive backup guides
              )
            )

        }
    }
    ```
  </Tab>

  <Tab title="3.x.x">
    ```kotlin theme={null}
    package io.portalhq.android.app

    import io.portalhq.android.Portal
    import io.portalhq.android.storage.cloud.google.GoogleStorage
    import io.portalhq.android.storage.mobile.Keychain

    class MainActivity : AppCompatActivity() {
        lateinit val portal: Portal

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)

            // 👇 Don't forget to replace below with your own Google Client ID.
            val gDrive = GoogleStorage(YOUR_GOOGLE_CLIENT_ID, signoutAfterUse = true)
            val backupOptions = BackupOptions(gdrive = gDrive)
            val keychain = Keychain(applicationContext)

            // Initialize the Portal instance
            portal = Portal(
                // A Portal client API key. You can obtain one from Portal's REST API.
                apiKey = CLIENT_API_KEY,
                // Provide this if you want to implement backup yourself
                backup = null,
                // The EVM network chain ID.
                chainId = 10143,
                // An instance of Portal's Keychain.
                keychain = keychain,
                // A map of chainIDs to Gateway URLs (e.g. Infura, Alchemy, etc.)
                gatewayConfig = mapOf(10143 to YOUR_GATEWAY_URL),
                // Provide configuration of backup options you want to use with Portal
                backupOptions = backupOptions
            )
        }
    }
    ```
  </Tab>
</Tabs>

Now that we have our Portal instance, the next step is to generate a wallet. Let's create one!

<Note>
  If you are using [Client Session Tokens (CSTs)](../../../resources/authentication-and-api-keys), this hint is for you.

  When your user's CST expires, all Portal SDKs will throw an error on the next MPC Operation the user makes (e.g. creating a wallet, backing up a wallet, recovering a wallet, or signing). For Android, the SDK will throw `PortalHttpUnauthorizedException` which you can use as an indicator to refresh your CST.
</Note>