diff --git a/docs/guides/install/azure-artifacts.md b/docs/guides/install/azure-artifacts.md
index a317dff434..659e75fd6f 100644
--- a/docs/guides/install/azure-artifacts.md
+++ b/docs/guides/install/azure-artifacts.md
@@ -8,17 +8,13 @@ In [Azure Artifact's](https://learn.microsoft.com/en-us/azure/devops/artifacts/n
 
 [Azure Artifacts](https://azure.microsoft.com/en-us/products/devops/artifacts) is a package management system for Azure DevOps. It allows you to host your own private npm registry, npm packages, and other types of packages as well.
 
-To use it with `bun install`, add a `bunfig.toml` file to your project with the following contents:
-
 ---
 
 ### Configure with bunfig.toml
 
 ---
 
-Make sure to replace `my-azure-artifacts-user` with your Azure Artifacts username, such as `jarred1234`.
-
-Set the `$NPM_PASSWORD` environment variable to your Azure Artifacts npm registry password and Bun will automatically replace it with the correct value. You can also choose not to use an environment variable and instead hardcode your password in the `bunfig.toml` file, but be careful not to commit it to source control.
+To use it with `bun install`, add a `bunfig.toml` file to your project with the following contents. Make sure to replace `my-azure-artifacts-user` with your Azure Artifacts username, such as `jarred1234`.
 
 ```toml#bunfig.toml
 [install.registry]
@@ -30,13 +26,19 @@ password = "$NPM_PASSWORD"
 
 ---
 
+Then assign your Azure Personal Access Token to the the `NPM_PASSWORD` environment variable. Bun [automatically reads](/docs/runtime/env) `.env` files, so create a file called `.env` in your project root. There is no need to base-64 encode this token! Bun will do this for you.
+
+```txt#.env
+NPM_PASSWORD=<paste token here>
+```
+
+---
+
 ### Configure with environment variables
 
 ---
 
-You can also use an environment variable to configure Azure Artifacts with `bun install`.
-
-Like with the `npm` CLI, the environment variable to use is `NPM_CONFIG_REGISTRY`. The URL should include `:username` and `:_password` as query parameters. Replace `<USERNAME>` and `<PASSWORD>` with the apprropriate values.
+To configure Azure Artifacts without `bunfig.toml`, you can set the `NPM_CONFIG_REGISTRY` environment variable. The URL should include `:username` and `:_password` as query parameters. Replace `<USERNAME>` and `<PASSWORD>` with the apprropriate values.
 
 ```bash#shell
 NPM_CONFIG_REGISTRY=https://pkgs.dev.azure.com/my-azure-artifacts-user/_packaging/my-azure-artifacts-user/npm/registry/:username=<USERNAME>:_password=<PASSWORD>