> ## Documentation Index
> Fetch the complete documentation index at: https://hacktronai-docs-changelog-feature-backfill.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Prepare scope, estimate credits, and start a white-box pentest.

Use this guide to prepare scope and start a White-box Pentest from the Hacktron
dashboard.

## Prerequisites

Before you start, make sure the organization has:

* A connected repository or an uploaded archive to assess
* The branch or commit you want Hacktron to use
* Any target URLs that should be tested, such as staging or production URLs
* Authentication instructions for protected areas, if the application requires
  sign-in
* Enough Whitebox Scan credits, or an organization owner who can add a payment
  method and buy credits

<Card title="Connect repositories" icon="code-branch" href="/platform/repositories">
  Connect GitHub, GitHub Enterprise Server, or GitLab before creating a pentest.
</Card>

## Create the pentest

<Steps>
  <Step title="Open Whitebox Scans">
    In the Hacktron dashboard, open the Whitebox Scans area and create a new
    scan.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_open_scan.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=adf3992ae4444fc812805b93f1cd8fd7" alt="Open a new Whitebox Scan in the Hacktron dashboard" width="2212" height="382" data-path="images/whitebox_open_scan.png" />
  </Step>

  <Step title="Choose the primary repository">
    Select the main repository and branch for the assessment. Add related
    repositories if the application spans multiple services.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_select_repository.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=b0f29a0bc15d8140e5a3bcbf835b4df8" alt="Select the primary repository and branch for the scan" width="2212" height="1256" data-path="images/whitebox_select_repository.png" />
  </Step>

  <Step title="Add runtime context">
    Add target URLs, login steps, test credentials, areas to emphasize, and any
    exclusions. Keep credentials scoped to a test account where possible.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_define_target.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=43da160f47f309517ea17f5d66b8807e" alt="Define target URLs and scope for the scan" width="2212" height="1256" data-path="images/whitebox_define_target.png" />

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_configure_access.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=170dfbdfc02234227f42c5432ae46253" alt="Configure access with login steps and test credentials" width="2336" height="1256" data-path="images/whitebox_configure_access.png" />
  </Step>

  <Step title="Estimate the cost">
    Run the cost estimate and wait for it to complete. Hacktron estimates the
    credit cost from the selected repositories and scope before the scan can
    start.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_cost_estimate.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=27bd16f24e51b087e40a1536228dde6d" alt="Run the credit cost estimate for the scan" width="2212" height="1256" data-path="images/whitebox_cost_estimate.png" />
  </Step>

  <Step title="Review and start">
    Review the scope and estimated credit cost. When the run starts, Hacktron
    deducts the estimated credits from the organization's Whitebox Scan credit
    balance. If the balance is too low, an owner can buy credits during
    checkout.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_credit_summary.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=721ee3249cda5552d2753d94ee3c7c7a" alt="Review the credit summary before starting the scan" width="2212" height="1256" data-path="images/whitebox_credit_summary.png" />
  </Step>

  <Step title="Track progress">
    Watch the run status in the dashboard. When the scan completes, review
    findings and export the output needed for remediation or audit evidence.

    <img src="https://mintcdn.com/hacktronai-docs-changelog-feature-backfill/sn9QM2b43tS7Ph_E/images/whitebox_track_progress.png?fit=max&auto=format&n=sn9QM2b43tS7Ph_E&q=85&s=0b95b8f5025072afcd25d9014a50dc21" alt="Track scan progress and review findings in the dashboard" width="2336" height="1256" data-path="images/whitebox_track_progress.png" />
  </Step>
</Steps>

## Scope checklist

| Item                | What to provide                                                                    |
| ------------------- | ---------------------------------------------------------------------------------- |
| Repository          | Primary repository URL, branch, and any related repositories.                      |
| Application targets | Staging, production, API, admin, or tenant-specific URLs in scope.                 |
| Authentication      | Test credentials, SSO notes, MFA bypass instructions, or invite steps.             |
| Sensitive areas     | Auth, billing, permissions, file upload, webhooks, AI agents, or admin paths.      |
| Exclusions          | Systems, data, tenants, destructive actions, or rate limits that are out of scope. |
| Context documents   | Architecture notes, threat models, API specs, or prior pentest reports.            |

<Warning>
  Do not provide personal user credentials or production secrets. Use dedicated
  test accounts and revoke them after the assessment.
</Warning>

## API option

You can also start Whitebox Scans from the REST API. The API follows the
same structure as the dashboard flow: create a cost estimation first, wait for a
completed or partial estimate with credits, then start the scan with the same
repositories and branches.

<Columns cols={2}>
  <Card title="Create cost estimation" icon="calculator" href="/api-reference/cost-estimations/create-cost-estimation">
    Estimate the credit cost for one or more repositories.
  </Card>

  <Card title="Trigger a Whitebox Scan" icon="shield-halved" href="/api-reference/scans/create-scan">
    Start a Whitebox Scan after the cost estimate is ready.
  </Card>
</Columns>

## Next steps

<Columns cols={2}>
  <Card title="Credits and billing" icon="credit-card" href="/white-box-pentest/billing">
    Understand balances, purchases, deductions, and refunds.
  </Card>
</Columns>
