# Create your App

Before integrating the Tonomy SDK on **mainnet** and **testet**, your app must be registered. This ensures your app is recognized during user logins and transactions.

For **local testing**, developers can run their app on [https://localhost:3000](https://localhost:3000/) and use the testnet SDK configuration. If so, the *steps on the rest of this page can be ignored*

### Step 1. Generate App Key

Save the generated private key safely.

{% tabs %}
{% tab title="No-code" %}
Go to [https://tonomy.foundation/generate-key](https://tonomy.foundation/generate-key/)

[<sub>*Source code*</sub>](https://github.com/Tonomy-Foundation/Tonomy-Foundation-Next-Website/blob/master/pages/generate-key.js)
{% endtab %}

{% tab title="Run code yourself" %}
{% hint style="success" %}
You will need to run on a Linux machine with a bash-like terminal with:

* Node v20+
* Docker
  {% endhint %}

```bash
git clone https://github.com/Tonomy-Foundation/Tonomy-ID-SDK.git
cd Tonomy-ID-SDK

# (optional) enable corepack (for yarn) if not done already
corepack enable

yarn
yarn run build
yarn run cli keys create
```

{% endtab %}
{% endtabs %}

### Step 2. Submit App Details

To register your app on both **testnet** and **mainnet**, please fill out the following form with the required details:&#x20;

📋 **Submit here:** [Tonomy App Registration Form](https://docs.google.com/forms/d/1NpMydhrzrI4K4cvXPHb9UNB-Cp8IgtLy-DJsLegaxBw/edit)


---

# 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.tonomy.io/build-web4-apps/register-app.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.
