--- title: Do a Discovery with the biGENIUS Discovery App CLI (Walkthrough) description: This guide will walk you through a full discovery generation process with the biGENIUS Discovery App CLI. --- [Skip to content](https://knowledge.bigenius-x.com/do-a-discovery-with-the-bigenius-discovery-app-cli-walkthrough#main-content) [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en) [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal?hsLang=en) [![TRI\_Logo\_biGENIUS\_2020\_RGB\_s](https://knowledge.bigenius-x.com/hs-fs/hubfs/Marketing/TRI_Logo_biGENIUS_2020_RGB_s.png?width=150&height=42&name=TRI_Logo_biGENIUS_2020_RGB_s.png)](https://www.bigenius-x.com/) Open main navigation Close main navigation - [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new) - [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal) How can we help you? - There are no suggestions because the search field is empty. 1. [biGENIUS-X Knowledge Base](https://knowledge.bigenius-x.com/?hsLang=en) 2. [Discovery application](https://knowledge.bigenius-x.com/discovery-application?hsLang=en) # Do a Discovery with the biGENIUS Discovery App CLI (Walkthrough)     ### Prerequisites To follow this walkthrough, you will need a [CSV test dataset](https://f926da42ec3845beb4acf72f.blob.core.windows.net/hubspotknowledgebase/bigenius_discovery_test_data_ADW.zip) and the biGENIUS Discovery App CLI for your operating system. This guide is based on the biGENIUS Discovery App CLI version 3.0.2.   First, extract the test files archive directly into the directory of your Discovery App. The resulting structure should look something like this: `C:/discovery-app` `│   bigenius-discovery-cli.exe` `└───bigenius_discovery_test_data_ADW` `        CreditCard.csv` `        Currency.csv` `        CurrencyRate.csv` `        Customer.csv` `        ...` ### Start biGENIUS Discovery App Open the integrated terminal of your operating system and navigate to the directory containing the `bigenius-discovery` executable. - **Windows** - In your terminal, run: ``` ./bigenius-discovery-cli.exe  ``` - **Linux** - First, you need to make the application executable. In your terminal, run the command: ``` chmod +x bigenius-discovery-cli ``` - - Then, you can start the application by running the command: ``` ./bigenius-discovery-cli ``` - **MacOS** - In your terminal, try running the app with the command: ``` ./bigenius-discovery-cli ``` - - If you receive a warning from the OS that the app cannot be started, you may need to bypass the macOS Gatekeeper service - Run the command: ``` xattr -d com.apple.quarantine bigenius-discovery-cli ``` - - Then, try to execute the app again: ``` ./bigenius-discovery-cli ``` - When running the app for the first time on your machine, you should see something like this in your terminal output: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-07-29-1504-AM.png?width=670&height=325&name=image-png-Feb-18-2026-09-07-29-1504-AM.png) When the app is started for the first time, some resources are created in the background. You can find these resources in the respective user-related directories of your operating system: - **Windows:** `%LOCALAPPDATA%\\biGENIUS\\DiscoveryApp` - **Linux:** `~/.local/share/biGENIUS/DiscoveryApp/` - **macOS:** `~/.local/share/biGENIUS/DiscoveryApp` ### Create New Discovery Configuration After starting the app in your terminal, we can now create our first discovery configuration using the test data we downloaded earlier. First, let's review the types of discovery configurations we can create in the app. Since our source data consists of simple CSV files, we are looking to create a discovery related to CSV files. Run the command: ``` create --list ``` This will list all available discovery types that we can use to create a new discovery configuration, and looks like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-08-31-1750-AM.png?width=670&height=736&name=image-png-Feb-18-2026-09-08-31-1750-AM.png) The list shows us a Discovery Type called *CSV Local*, which is exactly what we need. In the app, we can create a new discovery configuration using the `create` command. For the `create` command, we need to provide a handful of parameters. We can determine these by inspecting the discovery type `CSV Local`. Run the command: ``` inspect --type "CSV Local" ``` This will show us a full description of the discovery type, and it looks like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-09-40-2144-AM.png?width=466&height=558&name=image-png-Feb-18-2026-09-09-40-2144-AM.png) Using this information, we can construct our `create` command. - The `FilePathType` for our example is `Directory` since all our CSV files are in a single directory. - The `FilePath` will be a relative path to the example data directory in our Discovery App folder: `bigenius_discovery_test_data_bfm/` - The `ColumnDelimiter` for all our files is a single pipe symbol `|`. - The `RowDelimiter` of our files will be `\\\\r\\\\n`. We need to escape the backslashes for the configuration to work correctly from the command line. - `FieldQuote` and `Length` can be ignored for this example. - The `Name` property is special, as all configurations require one, and it is provided differently. Let's construct our command. The `create` command needs the following arguments: - **Discovery Type:** In our case, this will be `CSV Local`. - **Name:** You can choose the name yourself. A suggestion is `csv_local_bfm_disc_01`. - **Properties:** The values we decided on earlier should be provided as a space-separated list to this argument, like: ``` FilePathType="Directory" FilePath="bigenius_discovery_test_data_ADW/" ColumnDelimiter="|" RowDelimiter="\\r\\n" ``` Execute the full command: ``` create "CSV Local" --name csv_local_ADW --properties FilePathType="Directory" FilePath="bigenius_discovery_test_data_ADW/" ColumnDelimiter="|" RowDelimiter="\\r\\n" ``` When the command completes, you should see output like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-15-59-5442-AM.png?width=670&height=137&name=image-png-Feb-18-2026-09-15-59-5442-AM.png) We can now inspect the discovery configuration to verify that the values were set correctly. Run the command: ``` inspect --name csv_local_ADW ``` This will show us the content of the configuration as we defined it in the create command: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-27-39-4931-AM.png?width=629&height=551&name=image-png-Feb-18-2026-09-27-39-4931-AM.png) ### Run Discovery Before we run our discovery, let's check the available discovery configurations. Run the command: ``` discover --list ``` You will see a list of all existing discovery configurations. If you haven't created any other configurations, you will see the one we just created. The output should look like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-29-09-3844-AM.png?width=295&height=87&name=image-png-Feb-18-2026-09-29-09-3844-AM.png) Now we can run the discovery and let the app generate the discovery file that we need for biGENIUS-X. Usually, the discovery file will be written by default into a directory structure within your operating system's user-specific directories. We can override this behavior and define our own output directory and file. Execute the command: ``` discover "csv_local_ADW" --output "discovery_file_csv_local_ADW.yaml" ``` If the discovery generation process was successful, you will see output like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-29-56-4641-AM.png?width=670&height=127&name=image-png-Feb-18-2026-09-29-56-4641-AM.png) Find the generated discovery file in the same directory as the application. The content of the generated discovery file should look like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-31-01-1327-AM.png?width=316&height=198&name=image-png-Feb-18-2026-09-31-01-1327-AM.png) You can now take this file and upload it to a Source System in biGENIUS-X. ### Run Discovery against biGENIUS-X Data Marketplace If you are using the biGENIUS-X Data Marketplace to manage your source systems, you can also directly upload a discovery to the Data Marketplace without creating the file locally and uploading it manually. Create a new Source System called ADW in the Data Marketplace in biGENIUS-X. Afterwards, you can run the `discover` command again, but this time we will provide additional information to connect directly to the biGENIUS-X API to upload the generated discovery file. Run the command: ``` discover "csv_local_ADW" --api-connection-properties ClientId="YOUR CLIENT ID" ClientSecret="YOUR CLIENT SECRET" SourceSystemName="ADW" Version="1.0.0" ``` If the upload was successful, the output should look like this:$ ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-35-39-9837-AM.png?width=670&height=206&name=image-png-Feb-18-2026-09-35-39-9837-AM.png) ### Side Note - Run Discovery with Sensitive Properties The biGENIUS Discovery App does not save any sensitive information for source systems that require passwords or access keys. When running a discovery against such a source system, we need to provide the values for sensitive properties in the `discover` command directly. Let's say we have a Microsoft SQL Server database that we want to discover. When using SQL Authentication, we have to provide a password in the `discover` command. To find out what properties are sensitive and need to be provided by the user, we can get a list of properties directly in the CLI by running the command: ``` discover --list-sensitive ``` Running this command against a SQL Server discovery configuration, the result would look like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-46-37-3874-AM.png?width=582&height=192&name=image-png-Feb-18-2026-09-46-37-3874-AM.png) This tells us that we need to provide a value for the `Password` property. The command for our example source system would look like this: ``` discover "ADW2019_Sales" --sensitive-properties Password="mySecretPassword" ``` ### Create Discovery with External Config File In an earlier step, we created a discovery configuration by providing each parameter through the command line. This can sometimes be tedious when we need to provide many parameters. To simplify this process, we also support loading external configuration files that contain the parameter values for a discovery configuration. In the directory where your executable is located, create a new file called *csv\_config.yaml*. Add the following content to the file and save it: ``` FilePathType: "Directory"FilePath: "bigenius_discovery_test_data_ADW/"ColumnDelimiter: "|"RowDelimiter: "\r\n" ``` This is the same content that we also provided via the parameters for the `create` command earlier. Let's create a new discovery configuration by using the `--sensitive-properties-file` argument instead of providing the parameters themselves. Run the command: ``` create "CSV Local" --name csv_local_ADW_2 --properties-file "csv_config.yaml" ``` The output is similar to the output from the previous `create` command: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-50-06-6826-AM.png?width=670&height=149&name=image-png-Feb-18-2026-09-50-06-6826-AM.png) We can also inspect the newly created configuration: ``` inspect --name csv_local_ADW_2 ``` This will show something like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-51-03-8732-AM.png?width=516&height=441&name=image-png-Feb-18-2026-09-51-03-8732-AM.png) The `discover` command for this newly created configuration follows the same pattern as before: ``` discover "csv_local_ADW_2" --output "discovery_file_csv_local_ADW_2.yaml" ``` This results in a response like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-52-59-7908-AM.png?width=670&height=123&name=image-png-Feb-18-2026-09-52-59-7908-AM.png) ### Create and Discover in One Command The Discovery CLI also supports a single-command solution if you want to create, run, and delete a discovery configuration using a single command. Instead of using the `create` command, then the `discover` command, and potentially the `delete` command, you can use the `create-and-discover` command with the `--delete-after` argument. Run the following command to see it in action: ``` create-and-discover "CSV Local" --name "csv_local_ADW_3" --properties-file "csv_config.yaml" --output "csv_local_ADW_3.yaml" --delete-after ``` The result should look like this: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-55-11-2258-AM.png?width=670&height=203&name=image-png-Feb-18-2026-09-55-11-2258-AM.png) We can see that the command performs three independent actions: First, it creates the discovery configuration, similar to the `create` command. Then, it runs the discovery configuration, similar to the `discover` command. Finally, it deletes the configuration, similar to the `delete` command. Of course, this can also be combined with the `--api-connection-properties` argument to directly upload the discovery file to the biGENIUS Data Marketplace. This command is useful if you want to integrate the discovery file generation into pipelines or other automated processes that support command-line execution. ### Execute Commands Outside the Discovery App The `create-and-discover` command provides a solution to generate discovery files in a single command. We can also execute this command from outside the Discovery App's interactive mode by providing the command and its arguments as parameters to the executable itself. If you are still inside the Discovery App's CLI, run the `exit` command to return to your terminal. Instead of running the executable and then running the `create-and-discover` command within the interactive shell, we can directly send the command to the executable. Run the following command directly from your operating system's terminal while located in the Discovery App directory created earlier:   `./bigenius-discovery-cli create-and-discover "CSV Local" --name "csv_local_bfm_disc_03" --properties-file "csv_config.yaml" --output "discovery_file_csv_local_bfm_disc_03.yaml" --delete-after` You will see that the app executes the provided command without entering the interactive shell mode and returns directly to the terminal: ![](https://knowledge.bigenius-x.com/hs-fs/hubfs/image-png-Feb-18-2026-09-56-58-6212-AM.png?width=670&height=238&name=image-png-Feb-18-2026-09-56-58-6212-AM.png) As mentioned, this approach allows you to integrate discovery file generation into various automation processes, like CI/CD pipelines.   - [Getting started](https://knowledge.bigenius-x.com/getting-started?hsLang=en#main-content) - [Guidelines](https://knowledge.bigenius-x.com/getting-started?hsLang=en#guidelines) - [Start working](https://knowledge.bigenius-x.com/getting-started?hsLang=en#start-working) - [Account](https://knowledge.bigenius-x.com/getting-started?hsLang=en#account) - [General overview](https://knowledge.bigenius-x.com/general-overview?hsLang=en) - [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en) - [Application Modules](https://knowledge.bigenius-x.com/application-modules?hsLang=en#main-content) - [Administration](https://knowledge.bigenius-x.com/application-modules?hsLang=en#administration) - [Solutions](https://knowledge.bigenius-x.com/application-modules?hsLang=en#solutions) - [Global Features](https://knowledge.bigenius-x.com/application-modules?hsLang=en#global-features) - [Projects](https://knowledge.bigenius-x.com/application-modules?hsLang=en#projects) - [Branches](https://knowledge.bigenius-x.com/application-modules?hsLang=en#branches) - [Data Connections](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-connections) - [Dataflow Modeling - Overview](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-overview) - [Dataflow Modeling - Wizard Steps](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-wizard-steps) - [Dataflow Modeling - Terms](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-terms) - [Dataflow Modeling - Term Mapping](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-term-mapping) - [Dataflow Modeling - Relationships](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-relationships) - [Dataflow Modeling - Data Quality](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-data-quality) - [Dataflow Modeling - Indexes](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-indexes) - [Relationship Modeling](https://knowledge.bigenius-x.com/application-modules?hsLang=en#relationship-modeling) - [Generate Artifacts](https://knowledge.bigenius-x.com/application-modules?hsLang=en#generate-artifacts) - [Project Settings](https://knowledge.bigenius-x.com/application-modules?hsLang=en#project-settings) - [Data Marketplace](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-marketplace) - [Generators](https://knowledge.bigenius-x.com/generators?hsLang=en#main-content) - [Fabric Warehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-warehouse) - [Fabric Lakehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-lakehouse) - [Databricks](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks) - [Snowflake](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake) - [Microsoft SQL Server](https://knowledge.bigenius-x.com/generators?hsLang=en#microsoft-sql-server) - [Artifacts](https://knowledge.bigenius-x.com/generators?hsLang=en#artifacts) - [Replace Placeholders](https://knowledge.bigenius-x.com/generators?hsLang=en#replace-placeholders) - [Target solution environment](https://knowledge.bigenius-x.com/generators?hsLang=en#target-solution-environment) - [Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment) - [Deployment with an Azuze DevOps pipeline](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment-with-an-azuze-devops-pipeline) - [Delta Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#delta-deployment) - [Load control environment](https://knowledge.bigenius-x.com/generators?hsLang=en#load-control-environment) - [Load data with a native load control](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-a-native-load-control) - [Load data with Apache Airflow](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-apache-airflow) - [Model Object Type](https://knowledge.bigenius-x.com/generators?hsLang=en#model-object-type) - [Properties](https://knowledge.bigenius-x.com/generators?hsLang=en#properties) - [Default Terms](https://knowledge.bigenius-x.com/generators?hsLang=en#default-terms) - [Discovery application](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#main-content) - [Discovery configurations](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#discovery-configurations) - [Best practices](https://knowledge.bigenius-x.com/best-practices?hsLang=en#main-content) - [Modeling Approaches](https://knowledge.bigenius-x.com/best-practices?hsLang=en#modeling-approaches) - [Use Cases](https://knowledge.bigenius-x.com/best-practices?hsLang=en#use-cases) - [Business Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#business-rules) - [Data Quality Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#data-quality-rules) - [FAQs](https://knowledge.bigenius-x.com/faqs?hsLang=en) - [Product Release Notes](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#main-content) - [SaaS Application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#saas-application) - [Discovery application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#discovery-application) - [Generators](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#generators) - [Legal Documents](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#main-content) - [Current legal docs](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#current-legal-docs) - [Software Product and Limits](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#software-product-and-limits) - [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en) - [Customer Portal](https://knowledge.bigenius-x.com/customer-portal) - [Sign in](https://knowledge.bigenius-x.com/_hcms/mem/login) [![biGENIUS logo](https://knowledge.bigenius-x.com/hubfs/TRI_Logo_biGENIUS_2020_RGB-1.svg "biGENIUS logo")](https://www.bigenius-x.com) All rights reserved © 2025, biGENIUS AG