Command Line Interface Reference#
This page contains all commands available in the dlt CLI and is generated
automatically from the fully populated python argparse object of dlt.
dlthub#
Creates, adds, inspects and deploys dlt pipelines. Further help is available at https://dlthub.com/docs/reference/command-line-interface.
Usage
dlthub [-h] [-v] [--non-interactive] [-y] [--debug] [--version]
[--disable-telemetry] [--enable-telemetry] [--no-pwd]
{dbt,workspace,show,serve,run,logout,login,job,deploy,profile,pipeline,local,init,ai}
...
Show Arguments and Options
Options
-h, --help- Show this help message and exit-v, --verbose- Increase verbosity. repeat for more (-v, -vv, -vvv).--non-interactive- Use prompt defaults; fail if a prompt has none. implied when stdin is not a tty.-y, --yes- Auto-accept confirmations. free-form prompts still need defaults.--debug- Show full stack traces on exceptions.--version- Show program's version number and exit--disable-telemetry- Disables telemetry before command is executed--enable-telemetry- Enables telemetry before command is executed--no-pwd- Do not add current working directory to sys.path. by default $pwd is added to reproduce python behavior when running scripts.
Available subcommands
dbt- Dlthub dbt transformation generatorworkspace- Workspace operations: connect, list, info, show, deploy, deployment, configurationshow- Open the dlthub dashboard (alias fordlthub workspace show)serve- Deploy and serve an interactive notebook/app (alias fordlthub job serve)run- Deploy code/config and run a script (alias fordlthub job run)logout- Log out from dlthublogin- Log in to dlthub (identity only)job- Job operations: list, info, run, serve, trigger, publish, unpublish, logs, cancel, runsdeploy- Sync code/config and deploy jobsprofile- Manage workspace built-in profilespipeline- Interact with pipelines running in dlthublocal- Operations on the local workspace (run, serve, info, show, clean, schema, telemetry, pipeline)init- Initialize a new dlthub workspaceai- Use ai-powered development tools and utilities
dlthub dbt#
dlthub dbt transformation generator.
Usage
dlthub dbt [-h] {generate} ...
Description
dlthub dbt transformation generator.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
Available subcommands
generate- Generate dbt project
dlthub dbt generate#
Generate dbt project.
Usage
dlthub dbt generate [-h] [--include_dlt_tables] [--fact [FACT]] [--force]
[--mart_table_prefix [MART_TABLE_PREFIX]] pipeline_name
Description
Generate dbt project.
Show Arguments and Options
Inherits arguments from dlthub dbt.
Positional arguments
pipeline_name- The pipeline to create a dbt project for
Options
-h, --help- Show this help message and exit--include_dlt_tables- Do not render _dlt tables--fact [FACT]- Create a fact table for a given table--force- Force overwrite of existing files--mart_table_prefix [MART_TABLE_PREFIX]- Prefix for mart tables
dlthub workspace#
Workspace operations: connect, list, info, show, deploy, deployment, configuration.
Usage
dlthub workspace [-h] [--timestamps]
{list,connect,info,show,deploy,deployment,configuration} ...
Description
Bind this project to a remote dltHub workspace and manage its deployments and configurations.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.
Available subcommands
list- List all workspaces you have access toconnect- Connects local to a remote workspace by name or idinfo- Show overview of current dlthub workspace (workspace, job count, latest run, latest deployment, latest configuration)show- Open the dlthub dashboard (alias fordlthub workspace show)deploy- Sync code/config and deploy jobsdeployment- Manipulate deployments in the workspaceconfiguration- Manipulate configurations in the workspace
dlthub workspace list#
List all workspaces you have access to.
Usage
dlthub workspace list [-h]
Description
List all workspaces you have access to.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Options
-h, --help- Show this help message and exit
dlthub workspace connect#
Connects local to a remote workspace by name or ID.
Usage
dlthub workspace connect [-h] [--create] [--org-id ORG_ID] [workspace]
Description
Connects local and remote workspaces. Jobs, pipelines and code available locally can then be deployed, scheduled and run in remote workspace.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Positional arguments
workspace- Workspace name or id to connect to. when omitted interactive picker will allow to select existing or create a new one
Options
-h, --help- Show this help message and exit--create---org-id ORG_ID- Organization uuid to scope the connection to. required in non-interactive mode when you belong to multiple organizations and local workspace has no organization pinned.
dlthub workspace info#
Show overview of current dltHub workspace (workspace, job count, latest run, latest deployment, latest configuration).
Usage
dlthub workspace info [-h]
Description
Show workspace ID and summary of deployments, configurations and jobs.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Options
-h, --help- Show this help message and exit
dlthub workspace show#
Open the dltHub dashboard (alias for dlthub workspace show).
Usage
dlthub workspace show [-h]
Description
Open link to the dltHub dashboard for current remote workspace.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Options
-h, --help- Show this help message and exit
dlthub workspace deploy#
Sync code/config and deploy jobs.
Usage
dlthub workspace deploy [-h] [--deployment DEPLOYMENT] [--dry-run]
[--show-manifest]
Description
Sync workspace files, generate job manifest from deployment.py, and reconcile jobs with the runtime. Use --dry-run to preview changes.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Options
-h, --help- Show this help message and exit--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--dry-run- Preview changes without applying them--show-manifest- Dump the expanded deployment manifest as yaml and exit
dlthub workspace deployment#
Manipulate deployments in the workspace.
Usage
dlthub workspace deployment [-h] [deployment_version_no] {list,info,sync} ...
Description
Manipulate deployments in the workspace.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Positional arguments
deployment_version_no- Deployment version number. only used in theinfosubcommand
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub workspace deployment list#
List all deployments in workspace.
Usage
dlthub workspace deployment [deployment_version_no] list [-h]
Description
List all deployments in workspace.
Show Arguments and Options
Inherits arguments from dlthub workspace deployment.
Options
-h, --help- Show this help message and exit
dlthub workspace deployment info#
Get detailed information about a deployment.
Usage
dlthub workspace deployment [deployment_version_no] info [-h]
Description
Get detailed information about a deployment.
Show Arguments and Options
Inherits arguments from dlthub workspace deployment.
Options
-h, --help- Show this help message and exit
dlthub workspace deployment sync#
Create new deployment if local workspace content changed.
Usage
dlthub workspace deployment [deployment_version_no] sync [-h] [--dry-run] [-v]
Description
Create new deployment if local workspace content changed.
Show Arguments and Options
Inherits arguments from dlthub workspace deployment.
Options
-h, --help- Show this help message and exit--dry-run- Compare local files to latest deployment without uploading-v, --verbose- Print per-file added/updated/deleted tree alongside the summary
dlthub workspace configuration#
Manipulate configurations in the workspace.
Usage
dlthub workspace configuration [-h] [configuration_version_no] {list,info,sync}
...
Description
Manipulate configurations in the workspace.
Show Arguments and Options
Inherits arguments from dlthub workspace.
Positional arguments
configuration_version_no- Configuration version number. only used in theinfosubcommand
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub workspace configuration list#
List all configuration versions.
Usage
dlthub workspace configuration [configuration_version_no] list [-h]
Description
List all configuration versions.
Show Arguments and Options
Inherits arguments from dlthub workspace configuration.
Options
-h, --help- Show this help message and exit
dlthub workspace configuration info#
Get detailed information about a configuration.
Usage
dlthub workspace configuration [configuration_version_no] info [-h]
Description
Get detailed information about a configuration.
Show Arguments and Options
Inherits arguments from dlthub workspace configuration.
Options
-h, --help- Show this help message and exit
dlthub workspace configuration sync#
Create new configuration if local config content changed.
Usage
dlthub workspace configuration [configuration_version_no] sync [-h] [--dry-run]
[-v]
Description
Create new configuration if local config content changed.
Show Arguments and Options
Inherits arguments from dlthub workspace configuration.
Options
-h, --help- Show this help message and exit--dry-run- Compare local config to latest configuration without uploading-v, --verbose- Print per-file added/updated/deleted tree alongside the summary
dlthub show#
Open the dltHub dashboard (alias for dlthub workspace show).
Usage
dlthub show [-h]
Description
Open link to the dltHub dashboard for current remote workspace.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
dlthub serve#
Deploy and serve an interactive notebook/app (alias for dlthub job serve).
Usage
dlthub serve [-h] [--deployment DEPLOYMENT] [--timestamps] [-f] [--job-ref REF]
[selector_or_job_ref]
Description
Deploy current workspace and run a notebook as a read-only web app. A plain .py script (marimo notebook, Streamlit app, FastMCP server, etc.) may also be passed and will be deployed and served remotely as a regular script. Alias for dlthub job serve.
Show Arguments and Options
Inherits arguments from dlthub.
Positional arguments
selector_or_job_ref- Selector or job ref to pick an interactive app from the manifest, or a .py file path to deploy and serve as a regular script
Options
-h, --help- Show this help message and exit--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.-f, --follow- Stream logs until the app stops--job-ref REF- Pick this job from the matched candidate set when the selector matches multiple jobs. errors if ref is not in the matched set.
dlthub run#
Deploy code/config and run a script (alias for dlthub job run).
Usage
dlthub run [-h] [--deployment DEPLOYMENT] [--timestamps] [-f] [--refresh]
[--job-ref REF] [selector_or_job_ref]
Description
Deploy current workspace and run a batch script remotely. Use -f/--follow to tail logs until completion. A plain .py script may also be passed: if it exposes no jobs it is deployed and executed remotely as a regular Python script. Alias for dlthub job run.
Show Arguments and Options
Inherits arguments from dlthub.
Positional arguments
selector_or_job_ref- Selector or job ref to pick a job from the manifest, or a .py file path to deploy and run as a regular script
Options
-h, --help- Show this help message and exit--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.-f, --follow- Follow status changes and stream logs until the run completes--refresh- Re-run from scratch (full reload). cascades to freshness-graph downstream jobs.--job-ref REF- Pick this job from the matched candidate set when the selector matches multiple jobs. errors if ref is not in the matched set.
dlthub logout#
Log out from dltHub.
Usage
dlthub logout [-h]
Description
Log out from dltHub.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
dlthub login#
Log in to dltHub (identity only).
Usage
dlthub login [-h] [--resume DEVICE_CODE]
Description
Log in to dltHub. Authenticates the current user; does not connect a workspace. Run dlthub workspace connect to bind this project to a remote workspace.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit--resume DEVICE_CODE- Resume a previously started device flow login. the device_code is printed bydlthub loginwhen no tty is attached.
dlthub job#
Job operations: list, info, run, serve, trigger, publish, unpublish, logs, cancel, runs.
Usage
dlthub job [-h] [--timestamps]
{list,info,show,trigger,publish,unpublish,logs,cancel,runs,serve,run} ...
Description
List and operate on jobs registered in the connected workspace, plus their runs.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.
Available subcommands
list- List jobs (filter with selectors: batch, schedule:*, tag, ...)info- Show job infoshow- Open the job page in the web guitrigger- Trigger jobs matching selectors (does not sync or deploy)publish- Generate or revoke a public link for an interactive notebook/appunpublish- Revoke the public link for an interactive notebook/applogs- Show logs for latest or selected job runcancel- Cancel active runs for matching jobsruns- Manage job runs: list, info, logs, cancelserve- Deploy and serve an interactive notebook/apprun- Deploy code/config and run a batch job
dlthub job list#
List jobs (filter with selectors: batch, schedule:*, tag, ...).
Usage
dlthub job list [-h] [--archived] [selector_or_job_name ...]
Description
List jobs registered in the workspace. Pass selectors to filter: batch, interactive, schedule:, tag:<name>, manual:, etc.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_name- Selector(s) or job name(s) used to filter the listing
Options
-h, --help- Show this help message and exit--archived- Include archived jobs in the listing (hidden by default)
dlthub job info#
Show job info.
Usage
dlthub job info [-h] [selector_or_job_name]
Description
Display detailed information about the job.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_name- Job name, script path, or selector identifying the job
Options
-h, --help- Show this help message and exit
dlthub job show#
Open the job page in the web GUI.
Usage
dlthub job show [-h] [selector_or_job_name]
Description
Print the URL of the job page in the dltHub dashboard and open it in a browser when interactive.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_name- Job name, script path, or selector identifying the job
Options
-h, --help- Show this help message and exit
dlthub job trigger#
Trigger jobs matching selectors (does not sync or deploy).
Usage
dlthub job trigger [-h] [--dry-run] [--profile PROFILE] [--refresh] selectors
[selectors ...]
Description
Trigger runs for jobs matching the given selectors. Can select only jobs already deployed. Does not sync code or deploy jobs. Examples: 'tag', 'manual.etl.', 'schedule:'.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selectors- Trigger selectors (fnmatch patterns), e.g. 'tag', 'manual.etl.*'
Options
-h, --help- Show this help message and exit--dry-run- Preview matched jobs without creating runs--profile PROFILE- Profile override for all triggered runs--refresh- Force a refresh on every triggered job (jobs skipped by freshness are not refreshed).
dlthub job publish#
Generate or revoke a public link for an interactive notebook/app.
Usage
dlthub job publish [-h] [--cancel] script_path
Description
Generate a public link for a notebook/app, or revoke it with --cancel.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
script_path- Local path to the notebook/app
Options
-h, --help- Show this help message and exit--cancel- Revoke the public link for the notebook/app
dlthub job unpublish#
Revoke the public link for an interactive notebook/app.
Usage
dlthub job unpublish [-h] script_path
Description
Revoke the public link for an interactive notebook/app.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
script_path- Local path to the notebook/app
Options
-h, --help- Show this help message and exit
dlthub job logs#
Show logs for latest or selected job run.
Usage
dlthub job logs [-h] [-f] selector_or_job_name [run_number]
Description
Show logs for the latest run of a job or a specific run number. Use -f/--follow to stream logs in real-time.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_name- Job name, script path, or selector (e.g. batch, schedule:*).run_number- Run number (optional)
Options
-h, --help- Show this help message and exit-f, --follow- Follow logs in real-time until the run completes
dlthub job cancel#
Cancel active runs for matching jobs.
Usage
dlthub job cancel [-h] [--dry-run] selector_or_job_name [selector_or_job_name
...]
Description
Cancel active (non-terminal) runs for jobs matching selectors or names. Multiple values cancel active runs for all matching jobs. Use --dry-run to preview.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_name- Job name, script path, or selector (e.g. batch, schedule:*).
Options
-h, --help- Show this help message and exit--dry-run- Show what would be cancelled without actually cancelling
dlthub job runs#
Manage job runs: list, info, logs, cancel.
Usage
dlthub job runs [-h] {list,info,logs,show,cancel} ...
Description
Operate on runs of a job: list runs, show info, stream logs, cancel.
Show Arguments and Options
Inherits arguments from dlthub job.
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub job runs list#
List job runs (filter with a selector: batch, schedule:*, ...).
Usage
dlthub job runs list [-h] [--running] [selector_or_job_name]
Description
List job runs registered in the workspace. Pass a selector to filter by matching jobs.
Show Arguments and Options
Inherits arguments from dlthub job runs.
Positional arguments
selector_or_job_name- Selector or job name to filter runs by
Options
-h, --help- Show this help message and exit--running- Show only runs that are not in a terminal state
dlthub job runs info#
Show job run info.
Usage
dlthub job runs info [-h] selector_or_job_name [run_number]
Description
Display detailed information about the job run.
Show Arguments and Options
Inherits arguments from dlthub job runs.
Positional arguments
selector_or_job_name- Job name, script path, or selectorrun_number- Run number (defaults to latest run of the given job)
Options
-h, --help- Show this help message and exit
dlthub job runs logs#
Show logs for the latest or selected job run.
Usage
dlthub job runs logs [-h] [-f] selector_or_job_name [run_number]
Description
Show logs for the latest or selected job run. Use -f/--follow to stream logs in real-time until completion.
Show Arguments and Options
Inherits arguments from dlthub job runs.
Positional arguments
selector_or_job_name- Job name, script path, or selectorrun_number- Run number (defaults to latest run)
Options
-h, --help- Show this help message and exit-f, --follow- Follow logs in real-time until the run completes
dlthub job runs show#
Open the job run page in the web GUI.
Usage
dlthub job runs show [-h] selector_or_job_name [run_number]
Description
Print the URL of the job run page in the dltHub dashboard and open it in a browser when interactive.
Show Arguments and Options
Inherits arguments from dlthub job runs.
Positional arguments
selector_or_job_name- Job name, script path, or selectorrun_number- Run number (defaults to latest run of the given job)
Options
-h, --help- Show this help message and exit
dlthub job runs cancel#
Cancel the latest or selected job run.
Usage
dlthub job runs cancel [-h] selector_or_job_name [run_number]
Description
Cancel the latest or selected job run.
Show Arguments and Options
Inherits arguments from dlthub job runs.
Positional arguments
selector_or_job_name- Job name, script path, or selectorrun_number- Run number (defaults to latest run)
Options
-h, --help- Show this help message and exit
dlthub job serve#
Deploy and serve an interactive notebook/app.
Usage
dlthub job serve [-h] [--deployment DEPLOYMENT] [--timestamps] [-f] [--job-ref
REF] [selector_or_job_ref]
Description
Deploy current workspace and run a notebook as a read-only web app. A plain .py script (marimo notebook, Streamlit app, FastMCP server, etc.) may also be passed and will be deployed and served remotely as a regular script.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_ref- Selector or job ref to pick an interactive app from the manifest, or a .py file path to deploy and serve as a regular script
Options
-h, --help- Show this help message and exit--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.-f, --follow- Stream logs until the app stops--job-ref REF- Pick this job from the matched candidate set when the selector matches multiple jobs. errors if ref is not in the matched set.
dlthub job run#
Deploy code/config and run a batch job.
Usage
dlthub job run [-h] [--deployment DEPLOYMENT] [--timestamps] [-f] [--refresh]
[--job-ref REF] [selector_or_job_ref]
Description
Deploy current workspace and run a batch script remotely. Use -f/--follow to tail logs until completion. A plain .py script may also be passed: if it exposes no jobs it is deployed and executed remotely as a regular Python script.
Show Arguments and Options
Inherits arguments from dlthub job.
Positional arguments
selector_or_job_ref- Selector or job ref to pick a job from the manifest, or a .py file path to deploy and run as a regular script
Options
-h, --help- Show this help message and exit--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.-f, --follow- Follow status changes and stream logs until the run completes--refresh- Re-run from scratch (full reload). cascades to freshness-graph downstream jobs.--job-ref REF- Pick this job from the matched candidate set when the selector matches multiple jobs. errors if ref is not in the matched set.
dlthub deploy#
Sync code/config and deploy jobs.
Usage
dlthub deploy [-h] [--timestamps] [--deployment DEPLOYMENT] [--dry-run]
[--show-manifest]
Description
Sync workspace files, generate job manifest from deployment.py, and reconcile jobs with the runtime. Use --dry-run to preview changes.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.--deployment DEPLOYMENT- Python file to use as manifest source (instead of deployment)--dry-run- Preview changes without applying them--show-manifest- Dump the expanded deployment manifest as yaml and exit
dlthub profile#
Manage Workspace built-in profiles.
Usage
dlthub profile [-h] {info,list} ...
Description
Show and list workspace profiles.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub profile info#
Display the active profile (paths, providers, pinned status).
Usage
dlthub profile info [-h]
Description
Display the active profile (paths, providers, pinned status).
Show Arguments and Options
Inherits arguments from dlthub profile.
Options
-h, --help- Show this help message and exit
dlthub profile list#
List all available profiles.
Usage
dlthub profile list [-h]
Description
List all available profiles.
Show Arguments and Options
Inherits arguments from dlthub profile.
Options
-h, --help- Show this help message and exit
dlthub pipeline#
Interact with pipelines running in dlthub.
Usage
dlthub pipeline [-h] {init,show,run} ...
Description
Create, run, inspect and monitor pipelines at dltHub.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub pipeline init#
Creates a pipeline in the current folder by adding existing verified source or creating a new one from template.
Usage
dlthub pipeline init [-h] [--list-sources] [--list-destinations] [--location
LOCATION] [--branch BRANCH] [--eject] [source] [destination]
Description
This command creates a new dlt pipeline script that loads data from source to destination. When you run the command, several things happen:
- Creates a basic project structure if the current folder is empty by adding
.dlt/config.toml,.dlt/secrets.toml, and.gitignorefiles. - Checks if the
sourceargument matches one of our verified sources and, if so, adds it to your project. - If the
sourceis unknown, uses a generic template to get you started. - Rewrites the pipeline scripts to use your
destination. - Creates sample config and credentials in
secrets.tomlandconfig.tomlfor the specified source and destination. - Creates
requirements.txtwith dependencies required by the source and destination. If one exists, prints instructions on what to add to it.
This command can be used several times in the same folder to add more sources, destinations, and pipelines. It will also update the verified source code to the newest
version if run again with an existing source name. You will be warned if files will be overwritten or if the dlt version needs an upgrade to run a particular pipeline.
Show Arguments and Options
Inherits arguments from dlthub pipeline.
Positional arguments
source- Name of data source for which to create a pipeline. adds existing verified source or creates a new pipeline template if verified source for your data source is not yet implemented.destination- Name of a destination i.e. bigquery or redshift
Options
-h, --help- Show this help message and exit--list-sources, -l- Shows all available verified sources and their short descriptions. for each source, it checks if your localdltversion requires an update and prints the relevant warning.--list-destinations- Shows the name of all core dlt destinations.--location LOCATION- Advanced. uses a specific url or local path to verified sources repository.--branch BRANCH- Advanced. uses specific branch of the verified sources repository to fetch the template.--eject- Ejects the source code of the core source like sql_database or rest_api so they will be editable by you.
dlthub pipeline show#
Open the pipeline observability view in the dltHub dashboard.
Usage
dlthub pipeline show [-h] pipeline_name
Description
Show the URL of the pipeline observability view in the dltHub dashboard and open it in a browser when interactive. Replaces the core dlt local-marimo pipeline show.
Show Arguments and Options
Inherits arguments from dlthub pipeline.
Positional arguments
pipeline_name- Name of the pipeline to show
Options
-h, --help- Show this help message and exit
dlthub pipeline run#
Run a job by pipeline name.
Usage
dlthub pipeline run [-h] [--timestamps] [-f] [--refresh] [--job-ref REF]
pipeline_name
Description
Run a job decorated with @run.pipeline, using pipeline_name: selector.
Show Arguments and Options
Inherits arguments from dlthub pipeline.
Positional arguments
pipeline_name- Name of the pipeline to run
Options
-h, --help- Show this help message and exit--timestamps- Show exact iso timestamps and precise durations (e.g. 1.291 s) instead of humanized relative times.-f, --follow- Follow status changes and stream logs until the run completes--refresh- Re-run from scratch (full reload). cascades to freshness-graph downstream jobs.--job-ref REF- Pick this job from the matched candidate set when the selector matches multiple jobs. errors if ref is not in the matched set.
dlthub local#
Operations on the local Workspace (run, serve, info, show, clean, schema, telemetry, pipeline).
Usage
dlthub local [-h] {info,show,run,serve,clean,profile,schema,telemetry,pipeline}
...
Description
Local-only operations on the current workspace.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
Available subcommands
info- Display detailed local workspace infoshow- Show workspace dashboardrun- Run a single batch workspace job locallyserve- Serve an interactive workspace job locally (notebook, dashboard, app)clean- Clean local data for the current profile. locally loaded data and pipelines working dirs are deleted by default. remote destinations are not affected.profile- Profile operations that affect only the local workspaceschema- Shows, converts and upgrades schemastelemetry- Shows telemetry statuspipeline- Local pipeline operations (info, drop, sync, load-package, etc.)
dlthub local info#
Display detailed local workspace info.
Usage
dlthub local info [-h]
Description
Display detailed local workspace info.
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit
dlthub local show#
Show workspace dashboard.
Usage
dlthub local show [-h] [--edit]
Description
Show workspace dashboard.
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit--edit- Eject dashboard and start editable version
dlthub local run#
Run a single batch workspace job locally.
Usage
dlthub local run [-h] [--deployment FILE] [--job-ref REF] [--profile NAME]
[--dry-run] [-c KEY=VALUE] [--start ISO] [--end ISO] [--refresh]
[selector_or_job_ref]
Description
Run one batch job by selector or job ref. A plain .py path is run as a regular script.
Show Arguments and Options
Inherits arguments from dlthub local.
Positional arguments
selector_or_job_ref- Job ref, trigger selector (tag:..., schedule:*), or a .py file to run as a script.
Options
-h, --help- Show this help message and exit--deployment FILE- Path to a .py deployment module. defaults to deployment.py.--job-ref REF- Pick this job when the selector matches multiple jobs.--profile NAME- Override require.profile and the workspace pinned profile.--dry-run- Resolve the job and print the entry point without launching-c KEY=VALUE, --config KEY=VALUE- Config key=value pairs passed to the job (repeatable)--start ISO- Override interval start (iso 8601). naive values use the job's timezone.--end ISO- Override interval end (iso 8601). defaults to now if --start is set.--refresh- Request a refresh run. honored unless the job declares refresh=block.
dlthub local serve#
Serve an interactive workspace job locally (notebook, dashboard, app).
Usage
dlthub local serve [-h] [--deployment FILE] [--job-ref REF] [--profile NAME]
[--dry-run] [-c KEY=VALUE] [selector_or_job_ref]
Description
Serve one interactive job (marimo, Streamlit, FastMCP, ...). Same selector / --job-ref semantics as dlthub local run.
Show Arguments and Options
Inherits arguments from dlthub local.
Positional arguments
selector_or_job_ref- Job ref, trigger selector (tag:..., schedule:*), or a .py file to run as a script.
Options
-h, --help- Show this help message and exit--deployment FILE- Path to a .py deployment module. defaults to deployment.py.--job-ref REF- Pick this job when the selector matches multiple jobs.--profile NAME- Override require.profile and the workspace pinned profile.--dry-run- Resolve the job and print the entry point without launching-c KEY=VALUE, --config KEY=VALUE- Config key=value pairs passed to the job (repeatable)
dlthub local clean#
Clean local data for the current profile. Locally loaded data and pipelines working dirs are deleted by default. Remote destinations are not affected.
Usage
dlthub local clean [-h] [--skip-local-data-dir]
Description
Clean local data for the current profile. Locally loaded data and pipelines working dirs are deleted by default. Remote destinations are not affected.
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit--skip-local-data-dir- Does not delete locally loaded data but removes pipeline working dirs.
dlthub local profile#
Profile operations that affect only the local workspace.
Usage
dlthub local profile [-h] {use} ...
Description
Profile operations scoped to the local workspace.
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit
Available subcommands
use- Pin a profile in the local workspace so subsequent local commands use it by default
dlthub local profile use#
Pin a profile in the local workspace so subsequent local commands use it by default.
Usage
dlthub local profile use [-h] profile_name
Description
Pin a profile in the local workspace so subsequent local commands use it by default.
Show Arguments and Options
Inherits arguments from dlthub local profile.
Positional arguments
profile_name- Profile name to pin
Options
-h, --help- Show this help message and exit
dlthub local schema#
Shows, converts and upgrades schemas.
Usage
dlthub local schema [-h] [--format {json,yaml,dbml,dot,mermaid}]
[--remove-defaults] file
Description
Loads, validates and prints out a dlt schema from a yaml or json file.
Show Arguments and Options
Inherits arguments from dlthub local.
Positional arguments
file- Schema file name, in yaml or json format, will autodetect based on extension
Options
-h, --help- Show this help message and exit--format {json,yaml,dbml,dot,mermaid}- Display schema in this format--remove-defaults- Does not show default hint values
dlthub local telemetry#
Shows telemetry status.
Usage
dlthub local telemetry [-h]
Description
Shows the current status of dlt telemetry. Learn more about telemetry and what we send in our telemetry docs.
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit
dlthub local pipeline#
Local pipeline operations (info, drop, sync, load-package, etc.).
Usage
dlthub local pipeline [-h] [--pipelines-dir PIPELINES_DIR]
{list,run,info,show,failed-jobs,drop-pending-packages,sync,trace,schema,drop,load-package}
...
Description
Local pipeline operations (info, drop, sync, load-package, etc.).
Show Arguments and Options
Inherits arguments from dlthub local.
Options
-h, --help- Show this help message and exit--pipelines-dir PIPELINES_DIR- Pipelines working directory
Available subcommands
list- List local pipelinesrun- Run a job by pipeline nameinfo- Displays state of the pipeline, use -v or -vv for more infoshow- Generates and launches workspace dashboard with the loading status and dataset explorerfailed-jobs- Displays information on all the failed loads in all completed packages, failed jobs and associated error messagesdrop-pending-packages- Deletes all extracted and normalized packages including those that are partially loaded.sync- Drops the local state of the pipeline and resets all the schemas and restores it from destination. the destination state, data and schemas are left intact.trace- Displays last run trace, use -v or -vv for more infoschema- Displays default schemadrop- Selectively drop tables and reset stateload-package- Displays information on load package, use -v or -vv for more info
dlthub local pipeline list#
List local pipelines.
Usage
dlthub local pipeline list [-h]
Description
List pipelines in the working directory.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Options
-h, --help- Show this help message and exit
dlthub local pipeline run#
Run a job by pipeline name.
Usage
dlthub local pipeline run [-h] [--job-ref REF] [--profile NAME] [--refresh]
[--dry-run] pipeline_name
Description
Run the job whose deliver.pipeline_name matches. Use --job-ref when multiple jobs target the same pipeline.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name to match againstdeliver.pipeline_name
Options
-h, --help- Show this help message and exit--job-ref REF- Narrow to this job when multiple jobs deliver to the same pipeline--profile NAME- Override require.profile and the workspace pinned profile.--refresh- Request a refresh run. honored unless the job declares refresh=block.--dry-run- Resolve the job and print the entry point without launching
dlthub local pipeline info#
Displays state of the pipeline, use -v or -vv for more info.
Usage
dlthub local pipeline info [-h] [pipeline_name]
Description
Displays the content of the working directory of the pipeline: dataset name, destination, list of
schemas, resources in schemas, list of completed and normalized load packages, and optionally a
pipeline state set by the resources during the extraction process.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit
dlthub local pipeline show#
Generates and launches workspace dashboard with the loading status and dataset explorer.
Usage
dlthub local pipeline show [-h] [--edit] [pipeline_name]
Description
Launches the workspace dashboard with a comprehensive interface to inspect the pipeline state, schemas, and data in the destination.
This dashboard should be executed from the same folder from which you ran the pipeline script to be able access destination credentials.
If the --edit flag is used, will launch the editable version of the dashboard if it exists in the current directory, or create this version and launch it in edit mode.
Requires marimo to be installed in the current environment: pip install marimo.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit--edit- Creates editable version of workspace dashboard in current directory if it does not exist there yet and launches it in edit mode.
dlthub local pipeline failed-jobs#
Displays information on all the failed loads in all completed packages, failed jobs and associated error messages.
Usage
dlthub local pipeline failed-jobs [-h] [pipeline_name]
Description
This command scans all the load packages looking for failed jobs and then displays information on
files that got loaded and the failure message from the destination.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit
dlthub local pipeline drop-pending-packages#
Deletes all extracted and normalized packages including those that are partially loaded.
Usage
dlthub local pipeline drop-pending-packages [-h] [pipeline_name]
Description
Removes all extracted and normalized packages in the pipeline's working dir.
dlt keeps extracted and normalized load packages in the pipeline working directory. When the run method is called, it will attempt to normalize and load
pending packages first. This command removes such packages. Note that pipeline state is not reverted to the state at which the deleted packages
were created. Using the sync sub-command is recommended if your destination supports state sync.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit
dlthub local pipeline sync#
Drops the local state of the pipeline and resets all the schemas and restores it from destination. The destination state, data and schemas are left intact.
Usage
dlthub local pipeline sync [-h] [--destination DESTINATION] [--dataset-name
DATASET_NAME] [pipeline_name]
Description
This command will remove the pipeline working directory with all pending packages, not synchronized
state changes, and schemas and retrieve the last synchronized data from the destination. If you drop
the dataset the pipeline is loading to, this command results in a complete reset of the pipeline state.
In case of a pipeline without a working directory, this command may be used to create one from the
destination. In order to do that, you need to pass the dataset name and destination name to the CLI
and provide the credentials to connect to the destination (i.e., in .dlt/secrets.toml) placed in the
folder where you run it.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit--destination DESTINATION- Sync from this destination when local pipeline state is missing.--dataset-name DATASET_NAME- Dataset name to sync from when local pipeline state is missing.
dlthub local pipeline trace#
Displays last run trace, use -v or -vv for more info.
Usage
dlthub local pipeline trace [-h] [pipeline_name]
Description
Displays the trace of the last pipeline run containing the start date of the run, elapsed time, and the
same information for all the steps (extract, normalize, and load). If any of the steps failed,
you'll see the message of the exceptions that caused that problem. Successful load and run steps
will display the load info instead.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit
dlthub local pipeline schema#
Displays default schema.
Usage
dlthub local pipeline schema [-h] [--format {json,yaml,dbml,dot,mermaid}]
[--remove-defaults] [pipeline_name]
Description
Displays the default schema for the selected pipeline.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline name
Options
-h, --help- Show this help message and exit--format {json,yaml,dbml,dot,mermaid}- Display schema in this format--remove-defaults- Does not show default hint values
dlthub local pipeline drop#
Selectively drop tables and reset state.
Usage
dlthub local pipeline drop [-h] [--destination DESTINATION] [--dataset-name
DATASET_NAME] [--drop-all] [--state-paths [STATE_PATHS ...]] [--schema
SCHEMA_NAME] [--state-only] [pipeline_name] [resources ...]
Description
Selectively drop tables and reset state.
dlt pipeline <pipeline name> drop [resource_1] [resource_2]
Drops tables generated by selected resources and resets the state associated with them. Mainly used
to force a full refresh on selected tables. In the example below, we drop all tables generated by
the repo_events resource in the GitHub pipeline:
dlt pipeline github_events drop repo_events
dlt will inform you of the names of dropped tables and the resource state slots that will be
reset:
About to drop the following data in dataset airflow_events_1 in destination dlt.destinations.duckdb:
Selected schema:: github_repo_events
Selected resource(s):: ['repo_events']
Table(s) to drop:: ['issues_event', 'fork_event', 'pull_request_event', 'pull_request_review_event', 'pull_request_review_comment_event', 'watch_event', 'issue_comment_event', 'push_event__payload__commits', 'push_event']
Resource(s) state to reset:: ['repo_events']
Source state path(s) to reset:: []
Do you want to apply these changes? [y/N]
As a result of the command above the following will happen:
- All the indicated tables will be dropped in the destination. Note that
dltdrops the nested
tables as well. - All the indicated tables will be removed from the indicated schema.
- The state for the resource
repo_eventswas found and will be reset. - New schema and state will be stored in the destination.
The drop command accepts several advanced settings:
- You can use regexes to select resources. Prepend the
re:string to indicate a regex pattern. The example
below will select all resources starting withrepo:
dlt pipeline github_events drop "re:^repo"
- You can drop all tables in the indicated schema:
dlt pipeline chess drop --drop-all
- You can indicate additional state slots to reset by passing JsonPath to the source state. In the example
below, we reset thearchivesslot in the source state:
dlt pipeline chess_pipeline drop --state-paths archives
This will select the archives key in the chess source.
{
"sources":{
"chess": {
"archives": [
"https://api.chess.com/pub/player/magnuscarlsen/games/2022/05"
]
}
}
}
This command is still experimental and the interface will most probably change.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline nameresources- One or more resources to drop. can be exact resource name(s) or regex pattern(s). regex patterns must start with re:
Options
-h, --help- Show this help message and exit--destination DESTINATION- Sync from this destination when local pipeline state is missing.--dataset-name DATASET_NAME- Dataset name to sync from when local pipeline state is missing.--drop-all- Drop all resources found in schema. supersedes [resources] argument.--state-paths [STATE_PATHS ...]- State keys or json paths to drop--schema SCHEMA_NAME- Schema name to drop from (if other than default schema).--state-only- Only wipe state for matching resources without dropping tables.
dlthub local pipeline load-package#
Displays information on load package, use -v or -vv for more info.
Usage
dlthub local pipeline load-package [-h] [pipeline_name] [load-id]
Description
Shows information on a load package with a given load_id. The load_id parameter defaults to the
most recent package. Package information includes its state (COMPLETED/PROCESSED) and list of all
jobs in a package with their statuses, file sizes, types, and in case of failed jobs—the error
messages from the destination. With the verbose flag set (-v), you can also see the
list of all tables and columns created at the destination during the loading of that package.
Show Arguments and Options
Inherits arguments from dlthub local pipeline.
Positional arguments
pipeline_name- Pipeline nameload-id- Load id of completed or normalized package. defaults to the most recent package.
Options
-h, --help- Show this help message and exit
dlthub init#
Initialize a new dlthub workspace.
Usage
dlthub init [-h] [--name NAME] [--force] [--dependencies
{auto,pyproject,requirements}] [--dry-run]
Description
Creates local workspace files: config, secrets, gitignore and Python pyproject/requirements.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit--name NAME- Workspace name (defaults to current directory basename).--force- Overwrite existing pyproject.toml/requirements.txt/.gitignore/config.toml.--dependencies {auto,pyproject,requirements}- Dependency file to scaffold.auto(default) uses pyproject.toml when uv is on path and requirements.txt otherwise.pyproject/requirementsforce the choice.--dry-run- Print the file plan without writing anything.
dlthub ai#
Use AI-powered development tools and utilities.
Usage
dlthub ai [-h] {status,init,secrets,toolkit,mcp} ...
Description
Configure your LLM-enabled IDE and MCP server.
Show Arguments and Options
Inherits arguments from dlthub.
Options
-h, --help- Show this help message and exit
Available subcommands
dlthub ai status#
Show AI setup status: dlt version, agent, toolkits, readiness checks.
Usage
dlthub ai status [-h]
Description
Show AI setup status: dlt version, agent, toolkits, readiness checks.
Show Arguments and Options
Inherits arguments from dlthub ai.
Options
-h, --help- Show this help message and exit
dlthub ai init#
Install initial AI rules and skills for your AI coding agent.
Usage
dlthub ai init [-h] [--agent {claude,cursor,codex}] [--location LOCATION]
[--branch BRANCH] [--overwrite]
Description
Install initial AI rules and skills for your AI coding agent.
Show Arguments and Options
Inherits arguments from dlthub ai.
Options
-h, --help- Show this help message and exit--agent {claude,cursor,codex}- Ai coding agent to install for. auto-detected if omitted.--location LOCATION- Advanced. git url or local path to ai workbench repository.--branch BRANCH- Advanced. git branch to fetch from.--overwrite- Overwrite existing files instead of skipping them.
dlthub ai secrets#
Manage secrets files used by dlt.
Usage
dlthub ai secrets [-h] {list,view-redacted,update-fragment} ...
Description
List, view (redacted), or update secret files used by dlt providers.
Show Arguments and Options
Inherits arguments from dlthub ai.
Options
-h, --help- Show this help message and exit
Available subcommands
list- List secret file locations from providersview-redacted- Print secrets toml with all values replaced by '***'update-fragment- Merge a toml fragment into the secrets file
dlthub ai secrets list#
List secret file locations from providers.
Usage
dlthub ai secrets list [-h]
Description
List secret file locations from providers.
Show Arguments and Options
Inherits arguments from dlthub ai secrets.
Options
-h, --help- Show this help message and exit
dlthub ai secrets view-redacted#
Print secrets TOML with all values replaced by '***'.
Usage
dlthub ai secrets view-redacted [-h] [--path PATH]
Description
Without --path, shows the unified view merged from all project secret files. With --path, shows that exact file.
Show Arguments and Options
Inherits arguments from dlthub ai secrets.
Options
-h, --help- Show this help message and exit--path PATH- Show this exact file instead of the unified provider view
dlthub ai secrets update-fragment#
Merge a TOML fragment into the secrets file.
Usage
dlthub ai secrets update-fragment [-h] --path PATH [fragment]
Description
Merge a TOML fragment into the secrets file.
Show Arguments and Options
Inherits arguments from dlthub ai secrets.
Positional arguments
fragment- Toml fragment string to merge; reads from stdin if omitted
Options
-h, --help- Show this help message and exit--path PATH- Path to the secrets toml file to write to
dlthub ai toolkit#
Manage AI toolkit plugins (list, info, install).
Usage
dlthub ai toolkit [-h] {list,info,install} ...
Description
Manage AI toolkit plugins (list, info, install).
Show Arguments and Options
Inherits arguments from dlthub ai.
Positional arguments
list- List available toolkitsinfo- Show toolkit contents and componentsinstall- Install toolkit components into project
Options
-h, --help- Show this help message and exit
dlthub ai toolkit list#
List available toolkits.
Usage
dlthub ai toolkit list [-h] [--location LOCATION] [--branch BRANCH]
Description
List available toolkits.
Show Arguments and Options
Inherits arguments from dlthub ai toolkit.
Options
-h, --help- Show this help message and exit--location LOCATION- Advanced. git url or local path to toolkit repository.--branch BRANCH- Advanced. git branch to fetch toolkit from.
dlthub ai toolkit info#
Show toolkit contents and components.
Usage
dlthub ai toolkit info [-h] [--location LOCATION] [--branch BRANCH] name
Description
Show toolkit contents and components.
Show Arguments and Options
Inherits arguments from dlthub ai toolkit.
Positional arguments
name- Toolkit name
Options
-h, --help- Show this help message and exit--location LOCATION- Advanced. git url or local path to toolkit repository.--branch BRANCH- Advanced. git branch to fetch toolkit from.
dlthub ai toolkit install#
Install toolkit components into project.
Usage
dlthub ai toolkit install [-h] [--location LOCATION] [--branch BRANCH] [--agent
{claude,cursor,codex}] [--overwrite] [--strict] name
Description
Install toolkit components into project.
Show Arguments and Options
Inherits arguments from dlthub ai toolkit.
Positional arguments
name- Toolkit name
Options
-h, --help- Show this help message and exit--location LOCATION- Advanced. git url or local path to toolkit repository.--branch BRANCH- Advanced. git branch to fetch toolkit from.--agent {claude,cursor,codex}- Ai coding agent to install for. auto-detected if omitted.--overwrite- Overwrite existing files instead of skipping them.--strict- Fail on validation warnings (invalid frontmatter, etc.).
dlthub ai mcp#
Run or install the dlt MCP server.
Usage
dlthub ai mcp [-h] [--stdio] [--sse] [--port PORT] [--features [FEATURES ...]]
{run,install} ...
Description
Run or install the dlt MCP server.
Show Arguments and Options
Inherits arguments from dlthub ai.
Positional arguments
run- Start the mcp server (default)install- Install mcp server config into the current project
Options
-h, --help- Show this help message and exit--stdio- Use stdio transport mode--sse- Use legacy sse transport instead of streamable-http--port PORT- Port for the mcp server (default: 8000)--features [FEATURES ...]- Mcp features to enable/disable. default: context, pipeline, secrets, toolkit, workspace. use +name to add, -name to remove (e.g. --features=-secrets,+context)
dlthub ai mcp run#
Start the MCP server (default).
Usage
dlthub ai mcp run [-h] [--stdio] [--sse] [--port PORT] [--features [FEATURES
...]]
Description
Start the MCP server (default).
Show Arguments and Options
Inherits arguments from dlthub ai mcp.
Options
-h, --help- Show this help message and exit--stdio- Use stdio transport mode--sse- Use legacy sse transport instead of streamable-http--port PORT- Port for the mcp server (default: 8000)--features [FEATURES ...]- Mcp features to enable/disable. default: context, pipeline, secrets, toolkit, workspace. use +name to add, -name to remove (e.g. --features=-secrets,+context)
dlthub ai mcp install#
Install MCP server config into the current project.
Usage
dlthub ai mcp install [-h] [--agent {claude,cursor,codex}] [--features [FEATURES
...]] [--name NAME] [--overwrite]
Description
Install MCP server config into the current project.
Show Arguments and Options
Inherits arguments from dlthub ai mcp.
Options
-h, --help- Show this help message and exit--agent {claude,cursor,codex}- Ai coding agent to install for. auto-detected if omitted.--features [FEATURES ...]- Mcp feature sets to include in the server config--name NAME- Server name in the mcp config (default: dlt-workspace)--overwrite- Overwrite existing server config instead of skipping.