add new hub env var section

website/docs/docs/build/environment-variables.md

@@ -97,7 +97,7 @@ While all environment variables are encrypted at rest in dbt Cloud, dbt Cloud ha
 
 dbt Cloud has a number of pre-defined variables built in. Variables are set automatically and cannot be changed.
 
-**dbt Cloud IDE details**
+#### dbt Cloud IDE details
 
 The following environment variable is set automatically for the dbt Cloud IDE:
 
@@ -109,13 +109,13 @@ The following environment variable is set automatically for the dbt Cloud IDE:
 
 Use case — This is useful in cases where you want to dynamically use the Git branch name as a prefix for a [development schema](/docs/build/custom-schemas) ( `{{ env_var ('DBT_CLOUD_GIT_BRANCH') }}` ).
 
-**dbt Cloud context**
+#### dbt Cloud context
 
 The following environment variables are set automatically for deployment runs:
 
 - `DBT_ENV`: This key is reserved for the dbt Cloud application and will always resolve to 'prod'
 
-**Run details**
+#### Run details
 - `DBT_CLOUD_PROJECT_ID`: The ID of the dbt Cloud Project for this run
 - `DBT_CLOUD_JOB_ID`: The ID of the dbt Cloud Job for this run
 - `DBT_CLOUD_RUN_ID`: The ID of this particular run
@@ -124,7 +124,7 @@ The following environment variables are set automatically for deployment runs:
 - `DBT_CLOUD_ENVIRONMENT_ID`: The ID of the environment for this run
 - `DBT_CLOUD_ACCOUNT_ID`: The ID of the dbt Cloud account for this run
 
-**Git details**
+#### Git details
 
 _The following variables are currently only available for GitHub, GitLab, and Azure DevOps PR builds triggered via a webhook_
 
@@ -186,3 +186,9 @@ select *,
 
 from users_aggregated
 ```
+
+### The DBT_PACKAGE_HUB_URL environment variable
+
+import PackageHubEnvVar from '/snippets/_dbt-package-hub-env-var.md';
+
+<PackageHubEnvVar/>

website/docs/docs/build/packages.md

@@ -94,7 +94,7 @@ Where possible, we recommend installing packages via dbt Hub, since this allows
 
 In comparison, other package installation methods are unable to handle the duplicate dbt-utils package. 
 
-Advanced users can choose to host an internal version of the package hub based on [this repository](https://github.com/dbt-labs/hub.getdbt.com) and setting the `DBT_PACKAGE_HUB_URL` environment variable.
+Advanced users can choose to host an internal version of the package hub based on [this repository](https://github.com/dbt-labs/hub.getdbt.com) and set the `DBT_PACKAGE_HUB_URL` environment variable. Refer to [Using the `DBT_PACKAGE_HUB_URL` environment variable](#using-the-dbt_package_hub_url-environment-variable) for more information.
 
 #### Prerelease versions
 
@@ -405,3 +405,8 @@ packages:
 
 </File>
 
+### The DBT_PACKAGE_HUB_URL environment variable
+
+import PackageHubEnvVar from '/snippets/_dbt-package-hub-env-var.md';
+
+<PackageHubEnvVar/>

website/snippets/_dbt-package-hub-env-var.md

@@ -0,0 +1,22 @@
+If you're hosting an internal version of the [dbt Labs hosted package hub](https://hub.getdbt.com/), you can set the [`DBT_PACKAGE_HUB_URL`](https://github.com/dbt-labs/dbt-core/blob/main/core/dbt/clients/registry.py#L23) environment variable to point to your instance of the dbt package hub. This allows you to install packages from your self-hosted version. 
+
+It provides organizations with the flexibility, control, and security when managing dbt packages:
+
+- Host internal dbt packages for organizational use — Useful for sharing sensitive or proprietary data models, macros, or other items across the organization.
+- Manage custom versions of public dbt packages — Useful for maintaining a fork of a public package with customizations or bug fixes.
+- Operate in secure, regulated, or air-gapped environments — Useful for organizations that require strict control over the software they use.
+- Gain control over package updates and dependencies — Useful for organizations that need to manage dependencies and updates carefully.
+
+To set the `DBT_PACKAGE_HUB_URL` environment variable:
+
+1. [Set the environment variable](/docs/build/environment-variables#setting-and-overriding-environment-variables) to the URL of your package hub.
+   <Lightbox src="/img/docs/building-a-dbt-project/set-env-var.jpg" title="Set up the 'DBT_PACKAGE_HUB_URL' environment variable in the Environment settings page."/>
+2. Configure the `packages.yml` file with the usual package name and version:
+
+    ```yaml
+        packages:
+        - package: santi_corp/package_name
+            version: [">=0.7.0", "<0.8.0"]
+    ```
+
+3. Run `dbt deps` to install the packages from your self-hosted package hub.