# System Initialization (Reference: https://docs.iqra.bot/developers/self-hosting/initialization)

Once the **Frontend** service is running, the platform enters "Install Mode." You must complete this wizard to seed the database and create your root administrator account.

1. The Installation Wizard [#1-the-installation-wizard]

Navigate to your frontend URL (e.g., `http://localhost` or `https://app.your-domain.com`). You will be redirected to `/install`.

<Steps>
  <Step>
    Admin Account [#admin-account]

    Create the **Root Administrator**.

    * **Email:** This will be used for system alerts.
    * **Password:** Set a strong password.
  </Step>

  <Step>
    Telemetry Settings [#telemetry-settings]

    We believe in transparency.

    * **Core Telemetry (Mandatory):** We collect your App Version and Admin Contact email. This allows us to notify you of critical security patches.
    * **Usage Telemetry (Optional):** You can opt-in to share aggregated stats (e.g., "Total Calls Processed", "Hardware Specs").
      * *Privacy:* No PII (Personally Identifiable Information) or conversation content is ever sent.
  </Step>

  <Step>
    Automatic Seeding [#automatic-seeding]

    Upon clicking **Install**, the system will populate the database with:

    * Default **Integration Types** (OpenAI, Twilio, etc.).
    * Default **Services** (LLM, TTS, STT definitions).
    * Default **Languages** list.
  </Step>
</Steps>

***

2. Registering Infrastructure [#2-registering-infrastructure]

Now that you are logged in, go to the **Admin Dashboard** (`/admin`). You need to tell the database where your worker nodes are running.

<Callout type="info" title="Deep Dive">
  For a detailed explanation of the topology fields, see the **[Admin Infrastructure Guide](/developers/admin/infrastructure)**.
</Callout>

<Steps>
  <Step>
    Create Region [#create-region]

    1. Navigate to **Infrastructure** -> **Regions**.
    2. Click **Add Region**.
    3. **Name:** `Default Region` (or `US-East`).
    4. **Identifier:** `us-east-1` (Used for routing logic).
  </Step>

  <Step>
    Register Proxy & Backend [#register-proxy--backend]

    Inside the Region view:

    1. **Add Proxy:**
       * **Endpoint:** The URL (e.g., `https://proxy.your-domain.com`). Toggle **SSL** if using HTTPS.
       * **SIP Port:** Define the port (Default: `5060`).
       * **Generate:** The system will create a **Server ID** and **API Key**. *Save these.*
    2. **Add Backend:**
       * **Endpoint:** The URL (e.g., `http://10.0.0.5:5002`).
       * **SIP Port:** Define the port (Default: `5080`).
       * **Generate:** Save the **Server ID** and **API Key**.
  </Step>

  <Step>
    Register Background Node [#register-background-node]

    Navigate to the **Background Node** tab (Top level of Infrastructure).

    1. **Endpoint:** The internal URL (e.g., `http://background:80`).
    2. **Generate:** Save the **API Key**.
  </Step>
</Steps>

***

🛑 3. Complete Deployment [#-3-complete-deployment]

You now have the **Server IDs** and **API Keys** required by your worker nodes.

<Callout type="error" title="Action Required">
  **Go back to your terminal.**

  1. Return to the **[Application Deployment](/developers/self-hosting/deployment#step-4-deploy-worker-nodes)** guide (Step 4).
  2. Update the `appsettings.json` (or Environment Variables) for your Proxy, Backend, and Background apps with the IDs/Keys you just generated.
  3. **Start the services.**
</Callout>

***

4. Verification [#4-verification]

Once all services are running and green:

1. **Create User:** Go to the User Dashboard and sign up a new standard user.
2. **Create Business:** Create a workspace.
3. **Add Integration:** Add a real OpenAI Key to the business.
4. **Test Call:** Use the "Make Calls" button.

If the call connects, audio flows, and the AI responds, your self-hosted cluster is fully operational.