Stib

English

Français

English

Français

Appearance

Connection ​

Connect the Stib mobile app to your server to manage your boards, cards, and agents from your phone or tablet. This guide covers both the QR code scan method and the manual URL entry.

Prerequisites ​

Before connecting the mobile app, make sure:

  • Stib server is running — the server must be started and accessible (check by visiting its URL in a browser)
  • Stib mobile app is installed — download it from your platform's app store or install the APK
  • Network access — your mobile device must be able to reach the server:
    • Local network: both the server and your phone must be on the same Wi-Fi / LAN
    • Remote access: the server must be exposed via a public URL (e.g., https://stib.example.com)

TIP

The default Stib server port is 50505. If you access the web UI at http://192.168.1.10:50505, you'll use the same address for the mobile app.

Connect via QR Code ​

The fastest way to connect is by scanning a QR code from the web interface:

  1. Open the Stib web UI in your browser
  2. Open User Settings from the sidebar
  3. In the General tab, find the Mobile connection section
  4. On your phone, open the Stib mobile app
  5. On the onboarding screen, tap Scan QR Code
  6. Point your camera at the QR code displayed on screen
  7. The app automatically reads the server address and connects

INFO

The QR code contains your server's address, port, and WebSocket URL. No credentials or tokens are transmitted — it is safe to display on screen.

Once scanned, the app validates the connection by contacting the server. If successful, you'll be taken to the project list.

Connect via Manual URL ​

If scanning a QR code is not possible, you can enter the server URL manually:

  1. Open the Stib mobile app
  2. On the onboarding screen, tap Enter URL manually
  3. Type your server address in the format:
    • Local: http://<server-ip>:50505
    • Public: https://stib.example.com
  4. Tap Connect

WARNING

Make sure the URL starts with http:// or https://. The app will reject URLs without a scheme.

TIP

If your app was installed with a pre-configured server URL, the URL field will be pre-filled. You can still change it.

Authentication Modes ​

After the mobile app connects to the server, its behavior depends on the authentication mode configured on the server:

Solo Mode (default) ​

If authentication is not enabled on the server, you get direct access to all projects and features. No login is required.

Collaborative Mode ​

If authentication is enabled, the app will prompt you to log in after connecting:

  • Username & password — enter your credentials
  • OIDC / SSO — tap the SSO button to authenticate through your identity provider

INFO

In collaborative mode, your session token is stored locally on the device. You stay logged in until you explicitly sign out or the token expires.

Reconnection Behavior ​

When the mobile app goes to the background (e.g., you switch to another app), the operating system may close the network connection. This is normal behavior on mobile devices.

When you return to the Stib app, it automatically reconnects to the server. You may see a brief loading indicator while the connection is re-established — no action is needed on your part.

Troubleshooting ​

If you have trouble connecting the mobile app, check the following common issues:

"Invalid URL" error ​

The URL must start with http:// or https://. Double-check the format and remove any trailing spaces.

"Unable to connect to the server" error ​

  • Verify the Stib server is running (try opening the URL in a browser)
  • Check that the IP address and port are correct
  • If using a local network, confirm both devices are on the same Wi-Fi
  • Check that no firewall is blocking port 50505

"Network error" error ​

Your device cannot reach the server at all. This usually means:

  • You are not connected to Wi-Fi or mobile data
  • The server is on a local network and your phone is on a different network
  • The server is behind a firewall without external access

"Authentication required" error ​

The server is running in collaborative mode. You need to log in with your credentials or use OIDC/SSO. If you don't have an account, contact your Stib administrator.

TIP

You can always change the server URL later from the app's settings screen if you need to connect to a different server.

Next Steps ​

Now that your mobile app is connected, head to the Mobile Usage guide to learn how to manage boards, cards, and agents from your phone.