Once you have the BYO sidecar up and running, the next step is to set up your backend to interact with the sidecar.

1. Install the client library for your backend language. Don’t see your language? Let us know.

   Node Python

   npm install @propelauth/byo-node

   pip install propelauth-byo

             npm install @propelauth/byo-node
           

             pip install propelauth-byo
           

2. Create an integration key for your application in the PropelAuth BYO dashboard. This is done by clicking the Gear Icon in the top right corner, selecting “Manage Settings”, and then navigating to the “Integration Keys” tab.

   

   After creating the key, make sure to copy the generated key as you will need it to initialize the client library in your application.

3. Initialize the client library in your application using the integration key you just created.

   Node Python

   import { createClient } from "@propelauth/byo-node";
   
   const client = createClient({
       url: 'http://localhost:2884', // Default sidecar URL
       integrationKey: 'api_...'
   });

   from propelauth_byo import create_client
   
   client = create_client(
       url='http://localhost:2884',  # Default sidecar URL
       integration_key='api_...'
   )

             import { createClient } from "@propelauth/byo-node";
   
   const client = createClient({
       url: 'http://localhost:2884', // Default sidecar URL
       integrationKey: 'api_...'
   });
           

             from propelauth_byo import create_client
   
   client = create_client(
       url='http://localhost:2884',  # Default sidecar URL
       integration_key='api_...'
   )
   
           

   In production, you’ll likely want to use environment variables or a secrets manager for your URL and integration key instead of hardcoding them.

4. To ensure that the client is working correctly you can run a simple test to check if it can communicate with the sidecar. This can be done by calling the ping method from the client library.

   Node Python

   const ping = await client.ping({});
   console.log(ping);
   // Output: { ok: true, data: { timestamp: 1753197674 }}

   ping = await client.ping()
   print(ping)
   # Output: Ok(data=PingResponse(timestamp=1753197674), ok=True)

             const ping = await client.ping({});
   console.log(ping);
   // Output: { ok: true, data: { timestamp: 1753197674 }}
           

             ping = await client.ping()
   print(ping)
   # Output: Ok(data=PingResponse(timestamp=1753197674), ok=True)
   
           

Next Steps

And you’re all set! The PropelAuth BYO client is now installed and ready to use in your application. You can start integrating PropelAuth BYO features such as Passkey support, Session Management, and more.