Skip to content

First connection

The box is installed and started, from the image or from the APT repository. What remains is to connect the app to it and, on a new box, to create its two accounts.

The app

Download the Android or Linux app from Downloads. The first connection is made from the local network, with one of these two apps.

The web version cannot reach a box on the local network

The box encrypts its connections with a self-signed certificate, which it created itself at its first boot. The browser refuses it: app.etm-powersync.fr only opens the demo.

1. Find the box

The phone (or computer) must be on the same network as the box — not on 4G, not on a guest network.

  1. Open the app, Installations screen.
  2. The box appears under Found on this network: tap it.
  3. If it is not there, add it by its address: etm-powersync.local for a box installed from the image, or the IP address your internet router gave it.

2. Confirm the certificate fingerprint

At the first connection, the app shows the box's name and the fingerprint of its certificate ("Box fingerprint (SHA-256 of the certificate)", then the fingerprint itself). Confirm it: the app remembers it for this box.

On later connections, everything happens without a question. If the certificate changes, the app refuses the connection and says so ("This box's certificate has changed"): nothing is sent to the box. No password is sent before this check.

3. A new box: create the two accounts

A new box has no account yet: the app detects this and offers to create them, one after the other. This applies to every new box, whether it is installed by an installer or by the customer themselves.

  1. The administrator account (the installer): a name and a password, entered twice. It is used for the wiring, the loads, the tariff and the safety limits.
  2. The user account (the customer): a name and a password, entered twice. It can monitor and control, not change the installation.

Passwords must have at least 8 characters, including one lowercase letter, one uppercase letter and one digit: this is the box's rule, and it refuses a weaker password.

If creating the user account fails, the administrator account stays created and you resume the step without starting over. You can also postpone it (Later) and do it afterwards from Settings.

The accounts stay on the box: they go through no online service. Write them down, there is no recovery by e-mail. The customer's password is not kept on the installer's phone: give the customer their name and password.

4. The customer connects

On their own phone, the customer adds the box the same way (detected on the network or by its address), confirms the fingerprint, then logs in with their user account.

Switching to administrator

Day to day, the app is connected with the user account. To change the installation, tap Switch to administrator (in the menu or in Settings) and enter the administrator name and password — every time: they are not remembered, and the administrator session token is never kept on the phone.

The administrator session closes by itself as soon as the app moves to the background, is closed or the phone locks, and after 15 minutes without a touch; or by hand with Leave administrator mode. The app then goes back to the user account.

There is no longer a PIN code or an "installer mode": the rights are those of the account connected to the box.

If the app cannot reach the box

Symptom What to check
The box is not detected is the phone on the same network as the box? Try by its address.
Timeout same network? On a virtual machine, a bridged network rather than NAT.
Connection refused is the service running? systemctl is-active nymead must answer active
"This box's certificate has changed" the box has been reinstalled, or it is not the same box: confirm nothing without knowing why
Unknown address the IP address may have changed: read it again in your internet router

Next

The app: add the devices, set up the EMS.