Configuring Custom SDK Endpoints

Point the Luciq Android SDK at a custom cluster endpoint, such as the EU regional cluster or a dedicated deployment, using a luciq_config.json 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 luciq_config.json resource 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 Android guide.
• Obtain the endpoints for your cluster from Luciq Support — these are not visible in your Luciq account.

Configure the endpoints

Step 1: Create the configuration file

1. Create a folder named raw inside your app's res directory (if it doesn't already exist).
2. Inside the raw folder, create a file named luciq_config.json.

Step 2: Set the endpoint keys

Add the following to luciq_config.json, setting each key to your cluster's domain:

Key	Description
luciq-domain	Domain for the SDK (bug reporting, crashes, sessions, etc.).
apm-domain	Domain for Application Performance Monitoring (APM).

res/raw/luciq_config.json

{
    "luciq-domain": "YOUR-SDK-DOMAIN",
    "apm-domain": "YOUR-APM-DOMAIN"
}

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 domains:

Key	EU domain
luciq-domain	api-eu.luciq.ai
apm-domain	api-eu-apm.luciq.ai

res/raw/luciq_config.json

{
    "luciq-domain": "api-eu.luciq.ai",
    "apm-domain": "api-eu-apm.luciq.ai"
}

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