---
url: https://flip-chart.ru/developers/en/on-premise/other/mobile-app.md
description: >-
  Connecting the flip mobile app to an on-premise server: allowing sign-in via
  the app, the server address and QR code, connecting on Android and iOS,
  managing servers and error messages.
---

# Mobile app

The flip mobile app for Android and iOS connects to flip installed on your organization's server. The space owner allows sign-in via the app and shares the server address or QR code with employees. Employees connect to the server from the app and sign in to their work account. The app stores several servers and switches between them.

## Requirements

* The **Mobile app** section is available only to the space owner.
* The flip mobile app for Android or iOS, version **1.0.35** or later, is installed on the device. Store links are listed in [flip mobile app](https://flip-chart.ru/knowledge-base/en/mobile-app).
* The server is reachable from the mobile device over the network.

## Allowing sign-in via the mobile app

1. In the web version of flip, in the left sidebar, click **Space settings** next to the space name.

2. Select the **Mobile app** section. While sign-in is turned off, the section shows the message "Sign-in via the mobile app is not allowed yet".

![The "Mobile app" section before sign-in is allowed](/on-premise/images/mobile-app/1.png)

3. Click **Enable**.

Once sign-in is enabled, the **Sign-in via mobile app** toggle appears at the top of the section, followed by the server settings, the QR code and the app download links.

![The "Mobile app" section with the server settings and the QR code](/on-premise/images/mobile-app/2.png)

## Sharing the server details with employees

Connecting requires the server address. It is shown in the **Server address** field; the copy icon on the right of the field copies the address to the clipboard.

The server QR code contains the server address, name and icon. Before sending the QR code, set how the server is displayed in the app:

1. Enter a name in the **Server display name** field.

2. In the **Server icon** block, select an icon.

3. Click **Save**. The "QR code updated" message appears.

::: warning QR code update
Changing the server name or icon updates the QR code. After a change, send the new QR code to employees.
:::

4. In the **Share QR code** card, click **Copy** to copy the QR code to the clipboard, or **Download QR code** to save it as an image.

### App installation links

In the **App installation** block, select a store: App Store, Google Play, AppGallery or RuStore. The **flip mobile app** window opens with the QR code of the app page. **Copy link** copies the store link, **Download QR code** saves the QR code as an image. The store is switched with the tabs at the top of the window.

![The "flip mobile app" window with the store QR code](/on-premise/images/mobile-app/3.png)

## Connecting to a server in the app

1. Open the flip mobile app and tap **Connect to server** on the sign-in screen. The **Connect to server** screen opens.

::: tip Note
If the app has saved servers, their list opens first. Select a server or tap **Add server**.
:::

2. Enter the server address, for example `company.flip.ru`.

3. If needed, fill in the **Display name** field and select a server icon.

4. Tap **Check**. If the server is available, the "Server found" message appears and the button changes to **Continue**.

![The "Connect to server" screen in the mobile app](/on-premise/images/mobile-app/4.png)

5. Tap **Continue**. The app downloads the version for this server; the progress is shown on the "Preparing flip" screen.

6. Sign in to your account on the server.

The **Go back** button under the server sign-in form returns to the sign-in screen of the cloud version of flip.

### Connecting with a QR code

* Android: on the **Connect to server** screen, tap **Scan QR code** and point the camera at the server QR code.
* iPhone and iPad: open the Camera app, point it at the server QR code and follow the link.

The server address, name and icon are filled in from the QR code, and the server is checked automatically. Tap **Continue** to finish.

If the link opens in the device browser, the "Continue in the mobile app" screen appears. Tap **Open in app**. On iPhone, this screen also has a **Download** button for installing the app.

## Managing servers

The name and address of the current server are shown at the top of the app's side menu. Tapping them opens the list of saved servers. The list also opens with the **Manage servers** item: on a phone — in the profile, on a tablet — in the account menu.

![The list of saved servers in the mobile app](/on-premise/images/mobile-app/5.png)

Actions in the list:

* Tapping a server switches the app to it.
* The **⋯** button next to a server opens the **Go to server**, **Edit** and **Delete** actions.
* The current server is listed first. Only editing is available for it.
* **Add server** connects one more server.

The **Edit server** window changes the display name and icon. The changes are saved only in the app on this device. If the name is empty, the server address is shown instead.

Deleting a server is confirmed in the "Delete server …?" window. Adding the server again requires signing in again.

## Links from server emails

Links from server emails, such as an invitation to a space or password recovery, open in the mobile app. If the link opens in the device browser, tap **Open in app** on the "Continue in the mobile app" screen.

If the link belongs to another server, the app asks for confirmation: "Switch to server "…"?". After confirmation, the app switches to that server and the session in the current account ends.

When a link to the cloud version of flip is opened while working on the organization's server, the app asks for confirmation: "Leave server "…"?". Tap **Go to flip** to proceed.

## Turning off sign-in via the mobile app

1. In the **Mobile app** section, turn off the **Sign-in via mobile app** toggle.

2. In the "Are you sure?" window, click **Turn off**.

::: warning Users are disconnected
After sign-in is turned off, all mobile app users are disconnected from the server. The app and an open flip show the message "Sign-in from the mobile app has been disabled by your administrator".
:::

## Error messages

| Message | Cause and action |
| --- | --- |
| "Server unavailable, check the address" | The server is not found at the specified address. Check the address and that the server is reachable from the device. |
| "Server is unavailable or outdated", "Update the server" | The server version does not support the mobile app. [Update the server](/en/on-premise/updates/instruction). |
| "Sign-in from the mobile app is disabled. Contact your administrator" | Sign-in via the app is not enabled in the **Mobile app** section. |
| "The mobile app is not available on this server. Contact your administrator" | The mobile app is not set up on the server. |
| "Too many attempts, try again later" | The number of server check attempts is exceeded. Try again later. |
| "Update the app to connect to this server" | The app version is outdated. Update the app in the store to version 1.0.35 or later. |
| "Check your internet connection" | The device has no network connection. |

## Limitations

* The list of servers is stored on the device. On another device, the servers are added again.
* Connecting to a server and switching between servers require a network connection.
* A license key cannot be activated in the mobile app. When the key expires, the owner sees the message "The license key has expired. Activate a new one in the web version of the app".
