Which UI do you use?

Custom UI

Pre built UI

How to enable debug logs

Enable backend logs

important

This is only available on versions:

• supertokens-node >= v9.1.2
• supertokens-golang >= v0.5.5
• supertokens-python >= v0.6.3

Our backend SDK provides useful logs that can help with debugging. To enable logging, you need to set the debug setting to true in the init function call:

NodeJS

Important

For other backend frameworks, you can follow our guide on how to spin up a separate server configured with the SuperTokens backend SDK to authenticate requests and issue session tokens.

GoLang

import supertokens from "supertokens-node";

supertokens.init({
    debug: true,
    supertokens: {
        connectionURI: "...",
    },
    appInfo: {
        apiDomain: "...",
        appName: "...",
        websiteDomain: "..."
    },
    recipeList: [/*...*/]
});

Python

import "github.com/supertokens/supertokens-golang/supertokens"

func main() {
    supertokens.Init(supertokens.TypeInput{
        Debug: true,
        Supertokens: &supertokens.ConnectionInfo{
            ConnectionURI: "...",
            APIKey:        "...",
        },
    })
}

Other Frameworks

from supertokens_python import init, InputAppInfo, SupertokensConfig

init(
    debug=True,
    app_info=InputAppInfo(api_domain="...", app_name="...", website_domain="..."),
    supertokens_config=SupertokensConfig(
       connection_uri='...',
       api_key='...'
    ),
    framework='flask', 
    recipe_list=[
       #...
    ]
)

Logs on your terminal have the following shape:

com.supertokens {"t": "2022-04-09T08:44:49.057Z", "sdkVer": "...", "message": "Started SuperTokens with debug logging (supertokens.init called)", "file": "..."}

• t: The time the log was generated
• sdkVer: Version of the SDK you are using
• message: The log message
• file: The file and line number from where this log was generated.

Enable frontend logs

Add enableDebugLogs when calling the init function:

ReactJS

You will have to make changes to the auth route config, as well as to the supertokens-web-js SDK config at the root of your application:

// this goes in the auth route config of your frontend app (once the pre built UI script has been loaded)

(window as any).supertokensUIInit("supertokensui", {
    enableDebugLogs: true,
    appInfo: { /*...*/ },
    recipeList: [/*...*/]
});

This change goes in the supertokens-web-js SDK config at the root of your application:

import SuperTokens from 'supertokens-web-js';
import Session from 'supertokens-web-js/recipe/session';

SuperTokens.init({
    appInfo: {
        apiDomain: "...",
        appName: "...",
    },
    recipeList: [
        Session.init(),
    ],
    enableDebugLogs: true,
});

Angular

import React from 'react';
import SuperTokens from "supertokens-auth-react";

SuperTokens.init({
    enableDebugLogs: true,
    appInfo: { /*...*/ },
    recipeList: [/*...*/]
});

Vue

You will have to make changes to the auth route config, as well as to the supertokens-web-js SDK config at the root of your application:

// this goes in the auth route config of your frontend app (once the pre built UI script has been loaded)

(window as any).supertokensUIInit("supertokensui", {
    enableDebugLogs: true,
    appInfo: { /*...*/ },
    recipeList: [/*...*/]
});

This change goes in the supertokens-web-js SDK config at the root of your application:

import SuperTokens from 'supertokens-web-js';
import Session from 'supertokens-web-js/recipe/session';

SuperTokens.init({
    appInfo: {
        apiDomain: "...",
        appName: "...",
    },
    recipeList: [
        Session.init(),
    ],
    enableDebugLogs: true,
});