> For the complete documentation index, see [llms.txt](https://docs.alphaess.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphaess.com/alpha-partner-legacy/basics/installation.md).

# Installation

Select the "System" category at the bottom of the screen, then click on "New installation" on the page, and finally click "Install system" to start commissioning.

The app now offers a revamped commissioning procedure and a built-in self-test function for select system models, seamlessly guiding users through the process. It automatically detects the system type and intelligently skips the self-test if incompatible.

{% columns %}
{% column %}

<figure><img src="/files/8G4RWQSBMc9lpBFEDrfa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/P5JtLuE8ftac53JgGXzE" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

### Step 1: System Network Configuration

The app will display a scanning frame. Please scan the QR code or barcode on the side of the system. The system will automatically recognize the system’s SN and Checkcode. You can click "How to find" to view an example.

{% columns %}
{% column %}

<figure><img src="/files/k9PbXElbHLUrGWzJP2HP" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/mk6NhoX1BcVUU20r8Auy" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

Select your installation identity for this setup. Once the installation is successful, the system will be bound to the organization account you choose, allowing you to access system data. If you have not yet joined an organization, you can enter the organization’s license to proceed with the installation.

{% columns %}
{% column %}

<figure><img src="/files/DMuHY6SspidOsxkIbnLJ" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

#### Step 1.1 Bluetooth Configuration

If the system supports Bluetooth connection, the system will automatically attempt to connect via Bluetooth. Once successfully connected, it will proceed to the next step.

{% columns %}
{% column %}

<figure><img src="/files/gYcpP6IT6FzHvIimQFPX" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/0cj34ze8tA31LQLVfiHc" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/jbUZQyynsxnuOedgd9ty" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Select the home router's name and enter the correct password to connect.

Wait for the system to connect to the network, then click "Next" to proceed.

#### Step 1.2 WiFi Configuration

* If the system supports hotspot connection, the system will automatically attempt to connect to the hotspot. Once successfully connected, it will proceed to the next step.
* If the system does not support automatic hotspot connection, please follow the instructions to manually complete the WiFi Direct connection.

Select the home router's name and enter the correct password to connect.

{% columns %}
{% column %}

<figure><img src="/files/HcYfLhXVM7wfIk3VJdQa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/zhYtDwmRSRpKH27MBcYz" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/rBJG3b478CMic9SbL4u5" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Wait for the system to connect to the network, then switch to mobile data or home WiFi as instructed.

If using a wired connection, you can determine whether the network cable is properly connected based on the on-screen prompts.

{% columns %}
{% column %}

<figure><img src="/files/VIVlXZefLT9FRhpikoYd" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/ETJ535Fw038l7u9zzh3E" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/0BuzHfHYHkRUyULN3Tv8" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Step 2: Parameter Configuration

On this screen, the system will attempt to connect to the cloud and come online.

During this process, you can proceed to fill in the Basic Information and Parameter Settings.

{% columns %}
{% column %}

<figure><img src="/files/2SwBJIU8AfkwnrW6vP7h" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

#### Step 2.1: Basic Information

After granting location access, the system will automatically fill in the country and time zone. Please complete any other missing information. The example below is for Netherlands.

System Name: Used to enter system remarks. After system commissioning is complete, you can view these remarks in the system list.

Quick Account Setup for End User: Upon entering a user's email address, the backend will automatically register an account for that end user and send them an email. The email will include account activation instructions, the user manual, and the app download link.

{% columns %}
{% column %}

<figure><img src="/files/v4WYPh6L62FLhyh6PBKm" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/gUOXvD3i4WzyfbIWdziD" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
We might improve the experience of installation, therefore this might be some changes on this screen. Follow the instructions on the app for the latest instructioin.
{% endhint %}

Step 2.2: System Parameter Settings

Fill in the parameter information correctly based on the actual conditions.

{% columns %}
{% column %}

<figure><img src="/files/84bhqH6eJ4Ub3lD7HTui" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/6NiUknZqMtJbioXPXUVg" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

### Step 3: Information Confirmation

Now you can confirm all the settings before submit it.

Once you have completed all the parameters, you can click "Export Config as Image" to review a summary of your settings and export it as an image file.

{% columns %}
{% column %}

<figure><img src="/files/I0lkzDxUzGW9rSaqTtd2" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/2zSEVJTO7eYsGlZDEg6T" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

### Step 4: Firmware Upgrade

If a new firmware version is detected, you can choose to upgrade the software version.

{% columns %}
{% column %}

<figure><img src="/files/lfXp4gw9lDWkzSnLDOwi" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
The mandatory upgrade will not be able to be skipped. We recommand to upgrade all the firmware.
{% endhint %}

### Step 5: Self-Testing

Before concluding the installation, a self-test must be conducted to ensure the system is operating normally.

{% hint style="info" %}
The Self-Testing screen will only be displayed when the system hardware and firmware support the self-testing. We will keep improving the self-testing features, please follow the instructions on the app.
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/urmOp8DvR9Vmm50x6Qpa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

You will see the system wiring diagram in landscape mode. Clicking the yellow arrow on the right will reveal the specific PV and grid data.

<figure><img src="/files/warPxm0IQL396AyZgQgj" alt="" width="375"><figcaption></figcaption></figure>

If an error is detected during the check, it will be marked with a red circle at the corresponding position. Clicking on this red error marker will display the error details and its solution.

<figure><img src="/files/2FGADAXUVS6vfLAOtDli" alt="" width="375"><figcaption></figcaption></figure>

If there are no errors, it will display "No errors detected". Click "Completed" to end the self-test.

<figure><img src="/files/H1v0a3ckHMmDJg0TRjUO" alt="" width="375"><figcaption></figcaption></figure>

#### Supported Fault Detection (SMILE-M5 Example)

> SMILE-G3 series fault detection will be available in a future release.

| Fault Type                 | Fault Name                        | Possible Cause                                                          | Quick Fix                                                                                                                                                                  |
| -------------------------- | --------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Battery Communication Lost | Battery Communication Lost        | Battery not powered on or communication cable loose                     | Press the battery button and ensure all battery LED indicators are lit                                                                                                     |
| Battery Voltage Abnormal   | Battery voltage sampling abnormal | Battery/inverter circuit breaker open or battery not started            | Press battery button, ensure battery and inverter circuit breakers are on, confirm all battery LEDs are lit                                                                |
| Meter Communication Lost   | Meter Communication Lost          | Communication cable loose, wrong port, or incorrect device type setting | <p>1. Confirm device type (Meter/CT)<br>2. Re-connect communication cable terminals<br>3. Ensure cable is in Meter/Grid\_CT port<br>4. Check wiring per T568B standard</p> |
| Grid CT Issue              | Grid CT wrong direction/position  | CT installed in wrong position or arrow pointing wrong direction        | <p>1. Ensure CT is clamped upstream of main switch<br>2. Confirm CT arrow points toward Load (downward)<br>3. Check wiring sequence</p>                                    |
| PV CT Issue                | PV CT wrong direction/position    | CT installed in wrong position or arrow pointing wrong direction        | <p>1. Confirm PV inverter power >100W<br>2. Ensure CT is on PV Grid output cable<br>3. Confirm CT arrow points toward Load (downward)</p>                                  |
| Circuit Breaker Tripped    | Circuit Breaker Tripped           | Battery circuit breaker not switched on                                 | Confirm all battery circuit breakers (CB) are switched on                                                                                                                  |

> 💡 If the fault persists after completing the above steps, please take photos and contact the AlphaESS customer service hotline.

### Step 6: Complete the installation

After completing the self-test, the system installation will be finished. On this interface, you can choose to configure the additional settings.

{% columns %}
{% column %}

<figure><img src="/files/AogCxo5lDro4JFLhDuap" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
After the installation, end user will receive an email about the installation and account will be initiated.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.alphaess.com/alpha-partner-legacy/basics/installation.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.