Configuring Custom SDK Endpoints

Point the Luciq iOS SDK at a custom cluster endpoint, such as a regional EU cluster or a dedicated deployment, using a LuciqConfig.plist file.

By default, the Luciq SDK sends all data to Luciq's default production cluster. If your account is hosted on a different cluster — for example a regional cluster such as the EU cluster, or a dedicated deployment — you need to point the SDK at that cluster's endpoints so your data is routed to the correct location.

You configure custom endpoints using a LuciqConfig.plist file. This is a one-time setup you do after integrating the SDK.

Custom endpoints are only required if your Luciq account is provisioned on a non-default cluster. If you're using the default cluster, you can skip this page — no endpoint configuration is needed.

Prerequisites

• Integrate the production SDK first, following the Integrate Luciq on iOS guide.
• Obtain the endpoints for your cluster from Luciq Support — these are not visible in your Luciq account.

Configure the endpoints

Step 1: Add the configuration file

Add a LuciqConfig.plist file to your project and include it in the target that runs Luciq.

Step 2: Set the endpoint keys

Open LuciqConfig.plist and set the following keys to your cluster's endpoints:

Key	Description
SDKBaseURL	Base URL for the SDK (bug reporting, crashes, sessions, etc.).
APMBaseURL	Base URL for Application Performance Monitoring (APM).

LuciqConfig.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>SDKBaseURL</key>
	<string>https://YOUR-SDK-ENDPOINT</string>
	<key>APMBaseURL</key>
	<string>https://YOUR-APM-ENDPOINT</string>
</dict>
</plist>

Step 3: Validate the configuration

Ensure the endpoints are reachable and correctly configured — the SDK sends all requests to the specified domains. Report a sample bug to confirm the data reaches your cluster.

EU cluster

To route your data to the EU cluster, use the following endpoints:

Key	EU endpoint
SDKBaseURL	https://api-eu.luciq.ai
APMBaseURL	https://api-eu-apm.luciq.ai

LuciqConfig.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>SDKBaseURL</key>
	<string>https://api-eu.luciq.ai</string>
	<key>APMBaseURL</key>
	<string>https://api-eu-apm.luciq.ai</string>
</dict>
</plist>

Make sure you also use the App Token generated for your EU account, not your default-cluster token.