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

# quick start

<Info>YumeBox does not provide nodes or subscriptions, please prepare the configuration file or subscription address first. </Info>

## First time use

<Steps>
  <Step title="Install APK">
    Download and install the APK from [GitHub Releases](https://github.com/YumeYucca/YumeBox/releases).

    | Version    | Geo Data     | Suitable Scenario       |
    | ---------- | ------------ | ----------------------- |
    | `builtin`  | Built-in     | First time installation |
    | `external` | Not built-in | Version update          |
  </Step>

  <Step title="Import configuration">
    Click **Add Configuration** on the configuration page. After filling in the configuration name, you can import it through a subscription link, local file or QR code.

    <Frame>
      <img src="https://mintcdn.com/yumebox/37Z_Xsb-cHWca0U0/images/guide/quickstart-import-config.png?fit=max&auto=format&n=37Z_Xsb-cHWca0U0&q=85&s=d9e6f970cc0ff9c2743c49f2abcb981b" alt="Add configuration file interface" noZoom={true} width="1126" height="205" data-path="images/guide/quickstart-import-config.png" />
    </Frame>
  </Step>

  <Step title="Select configuration">
    Click on the configuration card to make it the current configuration.

    <Info> It is recommended not to add overrides when starting for the first time, and then modify it after confirming that the configuration can run normally. </Info>

    <Frame>
      <img src="https://mintcdn.com/yumebox/37Z_Xsb-cHWca0U0/images/guide/quickstart-profile-card.jpg?fit=max&auto=format&n=37Z_Xsb-cHWca0U0&q=85&s=8a2ead4d5fae8283cc5d79e0acc7439f" alt="Configure card interface" noZoom={true} width="1194" height="631" data-path="images/guide/quickstart-profile-card.jpg" />
    </Frame>
  </Step>

  <Step title="Service configuration">
    Open **Network Settings** and select the operating mode:

    | Mode          | Permissions | Features                             |
    | ------------- | ----------- | ------------------------------------ |
    | `Vpn Service` | VPN         | No Root required, good compatibility |
    | `Tun`         | Root        | Create Tun virtual network card      |
    | `eBPF`        | Root, eBPF  | Bridge traffic using eBPF            |

    <Info>`eBPF` requires kernel support, currently in the `alpha` stage, </Info> may be removed in the future
  </Step>

  <Step title="Start agent">
    Return to the homepage, click Start and complete system authorization.

    <Check>After the agent group and node are loaded, you can start using it. </Check>
  </Step>
</Steps>