Abrova
☰ Docs menu · SDK configuration

Self-Hosted SDK Configuration

Coming soon: configure all 6 Abrova Trace SDKs (Flutter, Next.js, Node.js, Android, iOS, Laravel) to point at your self-hosted Trace API with apiUrl.

Last updated: 27 Oct 2026
Coming soon.

Self-hosted Abrova Trace is not available yet. This page shows how the SDKs will point at your own server. For Abrova's cloud, leave apiUrl out — the SDKs use https://trace.abrova.ir by default. Questions? Contact us.

SDK Configuration for Self-Hosted#

All 6 SDKs work with self-hosted. Just add apiUrl pointing to your server. Everything else stays the same.

Flutter#

dart
await AbrovaTrace.initWithZone(
AbrovaTraceConfig(
  apiKey: 'ab_live_your_api_key_here',
  apiUrl: 'http://your-server:3001',  // Your self-hosted Trace API
  environment: 'production',
  release: '1.0.0',
  captureUncaughtErrors: true,
),
() async {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
},
);

Next.js#

tsx
AbrovaTrace.init({
  apiKey: 'ab_live_your_api_key',
  apiUrl: 'http://your-server:3001',  // Your self-hosted Trace API
  environment: process.env.NODE_ENV,
  release: process.env.NEXT_PUBLIC_APP_VERSION,
});

Node.js#

javascript
const AbrovaTrace = require('@abrova-trace/nodejs-sdk');

AbrovaTrace.init({
  apiKey: 'ab_live_your_api_key_here',
  serverSecret: 'ab_srv_your_server_secret_here',
  apiUrl: 'http://your-server:3001',  // Your self-hosted Trace API
  environment: 'production',
  release: '1.0.0'
});

Android (Kotlin)#

kotlin
val config = AbrovaTraceConfig.Builder("ab_live_your_api_key")
    .apiUrl("http://your-server:3001")  // Your self-hosted Trace API
    .environment(if (BuildConfig.DEBUG) "development" else "production")
    .release(BuildConfig.VERSION_NAME)
    .build()

AbrovaTrace.init(this, config)

iOS (Swift)#

swift
let config = AbrovaTraceConfigBuilder(apiKey: "ab_live_your_api_key")
    .apiUrl("http://your-server:3001")  // Your self-hosted Trace API
    .environment("production")
    .release(Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String)
    .build()

AbrovaTrace.shared.initialize(config: config)

Laravel#

Add to your .env:

bash
ABROVATRACE_API_URL=http://your-server:3001
ABROVATRACE_API_KEY=ab_live_your_api_key_here
ABROVATRACE_SERVER_SECRET=ab_srv_your_secret_here
ABROVATRACE_ENVIRONMENT=production

Notes#

  • Replace your-server:3001 with your actual server IP or domain
  • For local development, use http://localhost:3001
  • For production, use HTTPS with a reverse proxy (nginx, Caddy)
  • Get your API key from the self-hosted Console dashboard
  • The app key (ab_live_...) goes into mobile and web apps; the server secret (ab_srv_...) belongs only on your servers — see Server Secret & Server Routes
  • All features (breadcrumbs, APM, logs, crash detection) work identically to cloud
Was this page helpful?
Report a problem