Skip to main content

Installation

Setting Up the Native App​

1. Share Your Account Identifier​

Share your organization's account identifier and region with the Ekai team so they can grant access to the Native App.

  1. Log in to Snowsight and click your profile at the bottom right.

    Click profile in Snowsight

  2. Navigate to Account → Account Details. Note your region (e.g. US East / N. Virginia). Copy and send this to ekai.

    Account Details showing region

  3. A detailed popup will appear. Copy and relay the highlighted fields to ekai.

    Account details popup

Once shared, Ekai will make the app package available and you can proceed with installation.

2. Request the Application​

  1. Ensure your user has the ACCOUNTADMIN role selected. If needed, you may switch roles by clicking your profile → your user.

  2. As ACCOUNTADMIN, navigate to Data Sharing → Private Sharing. The native app package will appear under the Shared with you tab. Alternatively, from the main side menu, you may click on "Catalog" and then "Apps".

    Private Sharing - Shared with you tab

  3. Click Get. An information popup will appear for your review. These outline the standard features the app will be using. You should click on “Agree and continue”, which will begin the app acquisition process. You may be asked to confirm your email address by snowflake.

3. Install​

  1. Click Get. An information popup will outline the standard features the app uses. Click Agree and continue, then click Get to begin installation.

    Agree and continue popup

  2. Wait while the app installs. This can take up to 3 minutes.

    Installation in progress

  3. After installation, click Configure.

    Configure option after install

  4. On the configuration screen, ensure ACCOUNTADMIN is selected at the top right, then grant External Access Integration.

    Grant External Access Integration
    App does not auto-start after EAI approval

    After approving the External Access Integration, the app will not automatically activate. This is intentional — services are not auto-started to avoid unexpected costs from background upgrades silently resuming services.

    To start the app, run the following stored procedure in a Snowflake worksheet:


    CALL EKAI__BUSINESS_DATA_LAB_FREE_PRIVATE_LISTING.ekai_native_app_public.resume_all_services();

  5. Finally, click Launch App to start using Ekai.

    Launch App screen

Preparing Your App User​

  1. When using the app, Snowflake enforces authorization. Simply log in.

    App login screen

  2. Click "Don't have an account?" and follow the email instructions to create a user account.

    Create account screen

  3. The app exposes two roles: ekai_app_admin and ekai_app_user. Grant these as needed (see Additional Considerations below or refer to App Access Control).

Additional Considerations​

Share an External Account with Ekai

Create a new Snowflake user and share its credentials with the Ekai team for support and setup. Grant this account the ekai_app_admin and ekai_app_user roles. The Ekai will help load your data and walk you through any remaining setup.