Overview

Server profiles let you save multiple C3 backend configurations in the mobile app. This is useful when you have multiple machines or switch between local and remote access.

Save configurations for home and work machines
Quick switch between local and ngrok connections
Store different credential sets securely
Configure notifications per profile
Associate projects with specific profiles

Profile Settings

Each server profile stores the following information:

Setting	Required	Description
Profile Name	Yes	A friendly name to identify the profile (e.g., "Home Mac", "Work PC")
Server URL	Yes	The backend server URL (e.g., "https://your-server.ngrok-free.app")
Username	Yes	Username for server authentication
Password	Yes	Password for server authentication (stored securely)
Use SSL/TLS	Optional	Enable for secure WebSocket connection (wss://)

Secure Credential Storage

Your credentials are stored separately in your device's secure storage (Keychain on iOS, Keystore on Android), not in the profile data itself.

Creating Profiles

There are two ways to create a server profile:

Option 1: Manual Creation

Open the Settings tab in the C3 app
Find the Server Profiles section
Tap the + button
Enter the profile name and server URL (required)
Enter username and password for authentication
Toggle Use SSL/TLS Connection if needed
Tap Create to save the profile

Option 2: QR Code Scan

Open the Settings tab
Tap the QR code icon next to the + button in Server Profiles
Scan the QR code displayed by your C3 backend
Review the pre-filled profile details
Tap Create to save

QR Code Benefits

Scanning a QR code automatically fills in the server URL, credentials, and SSL settings. This is the fastest and most error-free way to set up a new profile.

Duplicate Detection

If you scan a QR code for a server that already has a profile, C3 will ask if you want to update the existing profile's credentials instead of creating a duplicate.

Managing Profiles

Editing Profiles

To edit an existing profile:

Find the profile in the Server Profiles section
Tap the pencil icon on the profile card
Update the settings as needed
Tap Save to apply changes

Deleting Profiles

To delete a profile:

Find the profile in the Server Profiles section
Tap the trash icon on the profile card
Confirm the deletion in the dialog

Projects Using Deleted Profiles

If any projects are associated with a deleted profile, they will be updated to have no profile association. You'll need to select a new profile when accessing those projects.

Backend Version

Each profile card shows the cached backend version. Tap the refresh icon next to the version to check for backend updates. If an update is available, you'll see a prompt with update instructions.

Project Association

Each project in C3 is associated with a specific server profile:

You select the server profile when creating or editing a project
The project uses that profile's connection settings
Different projects can use different profiles
This allows you to work on projects across multiple machines

Multi-Machine Workflow

If you have the same project on multiple machines (home and work), create separate projects in C3 pointing to each location, each with its own server profile.

Per-Profile Notifications

Each server profile has its own notification settings, allowing you to control which backends send you push notifications.

Enabling Notifications

Find the profile in the Server Profiles section
Toggle the Notifications switch to on
Grant notification permissions when prompted by your device

Notification Preferences

Once notifications are enabled for a profile, you can configure:

All Messages — Get notified for every agent message
Needs Attention — Get notified when permission approval is needed

Recommended Setup

For most users, we recommend enabling only Needs Attention notifications. This keeps you informed when the agent needs approval without overwhelming you with every message.

See the Notifications page for more details on notification behavior and troubleshooting.