docs: use coder modules in offline deployments

matifali · web-flow · commit 64f75b96faed · 2024-01-24T03:56:10.000+03:00
diff --git a/docs/install/offline.md b/docs/install/offline.md
@@ -230,6 +230,49 @@ server, as demonstrated in the example below:
 With these steps, you'll have the Coder documentation hosted on your server and
 accessible for your team to use.
 
+## Coder Modules
+
+## Air-gapped Users
+
+Air gapped users can clone the [coder/modules](htpps://github.com/coder/modules) repo and publish a [local terraform module repository](https://jfrog.com/help/r/jfrog-artifactory-documentation/set-up-a-terraform-module/provider-registry) to resolve modules via [Artifactory](https://jfrog.com/artifactory/).
+
+1. Create a local-terraform-repository with name `coder-modules-local`
+2. Create a virtual repositoty with name `tf`
+3. Follow the below instructions to publsh coder modules to Artifactory 
+
+  ```shell
+  git clone https://github.com/coder/modules
+  cd modules
+  jf tfc
+  jf tf p --namespace="coder" --provider="coder" --tag="1.0.0"
+  ```
+
+4. Generate a token with accesss to the `tf` repo and set an `ENV` variable `TF_TOKEN_example.jfrog.io="XXXXXXXXXXXXXXX"` on the Coder provisioner.
+5. Create a file `.terraformrc` with follwing content and mount at `/home/coder/.terraformrc` within the Coder provisioner.
+   
+  ```hcl
+  provider_installation {
+    direct {
+        exclude = ["registry.terraform.io/*/*"]
+    }
+    network_mirror {
+        url = "https://jfrt.cdr.dev/artifactory/api/terraform/tf/providers/"
+    }
+  }
+  ```
+7. Update module source as,
+  
+  ```hcl 
+  module "module-name" {
+    source = "https://jfrog.example.com/tf__coder/module-name/coder"
+    version = "1.0.0"
+    agent_id = coder_agent.example.id
+    ...
+  }
+  ```
+
+Based on the instructions [here](https://jfrog.com/blog/tour-terraform-registries-in-artifactory/).
+
 ## Firewall exceptions
 
 In restricted internet networks, Coder may require connection to internet.
