---
title: "Upload Debug Symbols"
description: "Learn more about how to upload debug symbols in Sentry Kotlin Multiplatform."
url: https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols/
---

# Upload Debug Symbols | Sentry for Kotlin Multiplatform

To symbolicate your stack traces, you need to provide debug information to Sentry. The symbolication process unscrambles the stack traces to reveal the function, file names, and line numbers of the crash.

## [Apple](https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols.md#apple)

For Apple applications please follow the iOS documentation on [Uploading Debug Symbols](https://docs.sentry.io/platforms/apple/guides/ios/dsym.md) to set up debug symbols upload.

## [Android](https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols.md#android)

### [Gradle](https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols.md#gradle)

To upload ProGuard mapping files or Native debug symbols via Gradle you need to install the [Sentry Android Gradle Plugin](https://docs.sentry.io/platforms/android/configuration/gradle.md) in your `androidApp` module:

`androidApp/build.gradle.kts`

```kotlin
plugins {
    id("com.android.application")
    id("io.sentry.android.gradle") version "6.4.0"
}

sentry {
  // Prevent Sentry dependencies from being included in the Android app through the AGP.
  autoInstallation {
    enabled.set(false)
  }

  // The slug of the Sentry organization to use for uploading proguard mappings/source contexts.
  org.set("___ORG_SLUG___")

  // The slug of the Sentry project to use for uploading proguard mappings/source contexts.
  projectName.set("___PROJECT_SLUG___")

  // The authentication token to use for uploading proguard mappings/source contexts.
  // WARNING: Do not expose this token in your build.gradle files, but rather set an environment
  // variable and read it into this property.
  authToken.set(System.getenv("SENTRY_AUTH_TOKEN"))
}
```

After installing the plugin, you need to configure your auth token as an environment variable:

```bash
export SENTRY_AUTH_TOKEN=___ORG_AUTH_TOKEN___
```

Once configured, the plugin will automatically upload the necessary debug symbols to Sentry when a release build is created.

#### [ProGuard/R8 & DexGuard](https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols.md#proguardr8--dexguard)

Learn more in the Sentry Gradle Plugin docs for [ProGuard/R8 & DexGuard](https://docs.sentry.io/platforms/android/configuration/gradle.md#proguardr8--dexguard).

#### [Native Debug Symbols and Sources](https://docs.sentry.io/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols.md#native-debug-symbols-and-sources)

You can find more information in the Sentry Gradle Plugin docs for [Native Debug Symbols and Sources](https://docs.sentry.io/platforms/android/configuration/gradle.md#native-debug-symbols-and-sources).