Aug 29, 2025 · Aug 28, 2025 · Aug 28, 2025 · Aug 28, 2025 · Aug 28, 2025 · Aug 28, 2025
diff --git a/docs/_redirects b/docs/_redirects
 # Redirect old offline deployments URL to new airgap URL
 /install/offline /install/airgap 301

 # Redirect old offline anchor fragments to new airgap anchors
 /install/offline#offline-docs /install/airgap#airgap-docs 301
 /install/offline#offline-container-images /install/airgap#airgap-container-images 301
diff --git a/docs/admin/integrations/index.md b/docs/admin/integrations/index.md
 The following resources may help as you're deploying Coder.

 - [Coder packages: one-click install on cloud providers](https://github.com/coder/packages)
 - [Deploy Coderoffline](../../install/offline.md)
 - [Deploy CoderAir-gapped](../../install/airgap.md)
 - [Supported resources (Terraform registry)](https://registry.terraform.io)
 - [Writing custom templates](../templates/index.md)
diff --git a/docs/admin/integrations/jfrog-artifactory.md b/docs/admin/integrations/jfrog-artifactory.md
 If you don't want to use the official modules, you can read through the [example template](https://github.com/coder/coder/tree/main/examples/jfrog/docker), which uses Docker as the underlying compute. The
 same concepts apply to all compute types.

 ##Offline Deployments
 ##Air-Gapped Deployments

 See the [offline deployments](../templates/extending-templates/modules.md#offline-installations) section for instructions on how to use Coder modules in an offline environment with Artifactory.
 See the [air-gapped deployments](../templates/extending-templates/modules.md#offline-installations) section for instructions on how to use Coder modules in an offline environment with Artifactory.

 ## Next Steps

diff --git a/docs/admin/networking/index.md b/docs/admin/networking/index.md
 Coder will use a relayed connection. By default,
 [Coder uses Google's public STUN server](../../reference/cli/server.md#--derp-server-stun-addresses),
 but this can be disabled or changed for
 [offline deployments](../../install/offline.md).
 [Air-gapped deployments](../../install/airgap.md).

 ### Relayed connections

 By default, your Coder server also runs a built-in DERP relay which can be used
 for both public and [offline deployments](../../install/offline.md).
 for both public and [Air-gapped deployments](../../install/airgap.md).

 However, our Wireguard integration through Tailscale has graciously allowed us
 to use
 #### Custom Relays

 If you want lower latency than what Tailscale offers or want additional DERP
 relays foroffline deployments, you may run custom DERP servers. Refer to
 relays forair-gapped deployments, you may run custom DERP servers. Refer to
 [Tailscale's documentation](https://tailscale.com/kb/1118/custom-derp-servers/#why-run-your-own-derp-server)
 to learn how to set them up.

diff --git a/docs/changelogs/v0.27.0.md b/docs/changelogs/v0.27.0.md
 - Template version messages (#8435)
  <img width="428" alt="252772262-087f1338-f1e2-49fb-81f2-358070a46484" src="https://github.com/coder/coder/assets/22407953/5f6e5e47-e61b-41f1-92fe-f624e92f8bd3">
 - TTL and max TTL validation increased to 30 days (#8258)
 - [Self-hosted docs](https://coder.com/docs/install/offline#offline-docs):
 - [Self-hosted docs](https://coder.com/docs/install/airgap#airgap-docs):
  Host your own copy of Coder's documentation in your own environment (#8527)
  (#8601)
 - Add custom coder bin path for `config-ssh` (#8425)
diff --git a/docs/changelogs/v2.8.0.md b/docs/changelogs/v2.8.0.md

 ### Documentation

 - Using coder modules inoffline deployments (#11788) (@matifali)
 - Using coder modules inair-gapped deployments (#11788) (@matifali)
 - Simplify JFrog integration docs (#11787) (@matifali)
 - Add guide for azure federation (#11864) (@ericpaulsen)
 - Fix example template README 404s and semantics (#11903) (@ericpaulsen)
diff --git a/docs/install/offline.md → docs/install/airgap.md b/docs/install/offline.md → docs/install/airgap.md
 # Offline Deployments

 All Coder features are supported in offline / behind firewalls / in air-gapped
 environments. However, some changes to your configuration are necessary.
 # Air-gapped Deployments

 All Coder features are supported in air-gapped / behind firewalls / disconnected / offline.
 This is a general comparison. Keep reading for a full tutorial running Coder
 offline with Kubernetes or Docker.
 air-gapped with Kubernetes or Docker.

 |                    | Public deployments                                                                                                                                                                                                                                                 |Offline deployments                                                                                                                                                                                                                                                                               |
 |                    | Public deployments                                                                                                                                                                                                                                                 |Air-gapped deployments                                                                                                                                                                                                                                                                               |
 |--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Terraform binary   | By default, Coder downloads Terraform binary from [releases.hashicorp.com](https://releases.hashicorp.com)                                                                                                                                                         | Terraform binary must be included in `PATH` for the VM or container image. [Supported versions](https://github.com/coder/coder/blob/main/provisioner/terraform/install.go#L23-L24)                                                                                                                   |
 | Terraform registry | Coder templates will attempt to download providers from [registry.terraform.io](https://registry.terraform.io) or [custom source addresses](https://developer.hashicorp.com/terraform/language/providers/requirements#source-addresses) specified in each template | [Custom source addresses](https://developer.hashicorp.com/terraform/language/providers/requirements#source-addresses) can be specified in each Coder template, or a custom registry/mirror can be used. More details below                                                                           |
 | Telemetry          | Telemetry is on by default, and [can be disabled](../reference/cli/server.md#--telemetry)                                                                                                                                                                          | Telemetry [can be disabled](../reference/cli/server.md#--telemetry)                                                                                                                                                                                                                                  |
 | Update check       | By default, Coder checks for updates from [GitHub releases](https://github.com/coder/coder/releases)                                                                                                                                                               | Update checks [can be disabled](../reference/cli/server.md#--update-check)                                                                                                                                                                                                                           |

 ##Offline container images
 ##Air-gapped container images

 The following instructions walk you through how to build a custom Coder server
 image for Docker or Kubernetes

 </div>

 ##Offline docs
 ##Air-gapped docs

 Coder also providesoffline documentation in case you want to host it on your
 Coder also providesair-gapped documentation in case you want to host it on your
 own server. The docs are exported as static files that you can host on any web
 server, as demonstrated in the example below:

diff --git a/docs/manifest.json b/docs/manifest.json
 ]
 },
 {
 "title": "Offline Deployments",
 "description": "Run Coder inoffline /air-gapped environments",
 "path": "./install/offline.md",
 "title": "Air-gapped Deployments",
 "description": "Run Coder in air-gapped / disconnected / offline environments",
 "path": "./install/airgap.md",
 "icon_path": "./images/icons/lan.svg"
 },
 {
diff --git a/docs/tutorials/faqs.md b/docs/tutorials/faqs.md
 ## Can I run Coder in an air-gapped or offline mode? (no Internet)?

 Yes, Coder can be deployed in
 [air-gapped or offline mode](../install/offline.md).
 [air-gapped or offline mode](../install/airgap.md).

 Our product bundles with the Terraform binary so assume access to terraform.io
 during installation. The docs outline rebuilding the Coder container with
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,6 @@
		# Redirect old offline deployments URL to new airgap URL
		/install/offline /install/airgap 301

		# Redirect old offline anchor fragments to new airgap anchors
		/install/offline#offline-docs /install/airgap#airgap-docs 301
		/install/offline#offline-container-images /install/airgap#airgap-container-images 301
Original file line number	Diff line number	Diff line change
Expand Up		@@ -13,6 +13,6 @@ our [installation guides](../../install/index.md).
		The following resources may help as you're deploying Coder.

		- [Coder packages: one-click install on cloud providers](https://github.com/coder/packages)
		- [Deploy Coderoffline](../../install/offline.md)
		- [Deploy CoderAir-gapped](../../install/airgap.md)
		- [Supported resources (Terraform registry)](https://registry.terraform.io)
		- [Writing custom templates](../templates/index.md)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -129,9 +129,9 @@ To set this up, follow these steps:
		If you don't want to use the official modules, you can read through the [example template](https://github.com/coder/coder/tree/main/examples/jfrog/docker), which uses Docker as the underlying compute. The
		same concepts apply to all compute types.

		##Offline Deployments
		##Air-Gapped Deployments

		See the [offline deployments](../templates/extending-templates/modules.md#offline-installations) section for instructions on how to use Coder modules in an offline environment with Artifactory.
		See the [air-gapped deployments](../templates/extending-templates/modules.md#offline-installations) section for instructions on how to use Coder modules in an offline environment with Artifactory.

		## Next Steps

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -116,12 +116,12 @@ If a direct connection is not available (e.g. client or server is behind NAT),
		Coder will use a relayed connection. By default,
		[Coder uses Google's public STUN server](../../reference/cli/server.md#--derp-server-stun-addresses),
		but this can be disabled or changed for
		[offline deployments](../../install/offline.md).
		[Air-gapped deployments](../../install/airgap.md).

		### Relayed connections

		By default, your Coder server also runs a built-in DERP relay which can be used
		for both public and [offline deployments](../../install/offline.md).
		for both public and [Air-gapped deployments](../../install/airgap.md).

		However, our Wireguard integration through Tailscale has graciously allowed us
		to use
Expand All		@@ -135,7 +135,7 @@ coder server --derp-config-url https://controlplane.tailscale.com/derpmap/defaul
		#### Custom Relays

		If you want lower latency than what Tailscale offers or want additional DERP
		relays foroffline deployments, you may run custom DERP servers. Refer to
		relays forair-gapped deployments, you may run custom DERP servers. Refer to
		[Tailscale's documentation](https://tailscale.com/kb/1118/custom-derp-servers/#why-run-your-own-derp-server)
		to learn how to set them up.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,7 +25,7 @@ Agent logs can be pushed after a workspace has started (#8528)
		- Template version messages (#8435)
		<img width="428" alt="252772262-087f1338-f1e2-49fb-81f2-358070a46484" src="https://github.com/coder/coder/assets/22407953/5f6e5e47-e61b-41f1-92fe-f624e92f8bd3">
		- TTL and max TTL validation increased to 30 days (#8258)
		- [Self-hosted docs](https://coder.com/docs/install/offline#offline-docs):
		- [Self-hosted docs](https://coder.com/docs/install/airgap#airgap-docs):
		Host your own copy of Coder's documentation in your own environment (#8527)
		(#8601)
		- Add custom coder bin path for `config-ssh` (#8425)
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -83,7 +83,7 @@

		### Documentation

		- Using coder modules inoffline deployments (#11788) (@matifali)
		- Using coder modules inair-gapped deployments (#11788) (@matifali)
		- Simplify JFrog integration docs (#11787) (@matifali)
		- Add guide for azure federation (#11864) (@ericpaulsen)
		- Fix example template README 404s and semantics (#11903) (@ericpaulsen)
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,12 +1,10 @@
		# Offline Deployments

		All Coder features are supported in offline / behind firewalls / in air-gapped
		environments. However, some changes to your configuration are necessary.
		# Air-gapped Deployments

		All Coder features are supported in air-gapped / behind firewalls / disconnected / offline.
		This is a general comparison. Keep reading for a full tutorial running Coder
		offline with Kubernetes or Docker.
		air-gapped with Kubernetes or Docker.

		\| \| Public deployments \|Offline deployments \|
		\| \| Public deployments \|Air-gapped deployments \|
		\|--------------------\|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|
		\| Terraform binary \| By default, Coder downloads Terraform binary from [releases.hashicorp.com](https://releases.hashicorp.com) \| Terraform binary must be included in `PATH` for the VM or container image. [Supported versions](https://github.com/coder/coder/blob/main/provisioner/terraform/install.go#L23-L24) \|
		\| Terraform registry \| Coder templates will attempt to download providers from [registry.terraform.io](https://registry.terraform.io) or [custom source addresses](https://developer.hashicorp.com/terraform/language/providers/requirements#source-addresses) specified in each template \| [Custom source addresses](https://developer.hashicorp.com/terraform/language/providers/requirements#source-addresses) can be specified in each Coder template, or a custom registry/mirror can be used. More details below \|
Expand All		@@ -16,7 +14,7 @@ offline with Kubernetes or Docker.
		\| Telemetry \| Telemetry is on by default, and [can be disabled](../reference/cli/server.md#--telemetry) \| Telemetry [can be disabled](../reference/cli/server.md#--telemetry) \|
		\| Update check \| By default, Coder checks for updates from [GitHub releases](https://github.com/coder/coder/releases) \| Update checks [can be disabled](../reference/cli/server.md#--update-check) \|

		##Offline container images
		##Air-gapped container images

		The following instructions walk you through how to build a custom Coder server
		image for Docker or Kubernetes
Expand DownExpand Up		@@ -214,9 +212,9 @@ coder:

		</div>

		##Offline docs
		##Air-gapped docs

		Coder also providesoffline documentation in case you want to host it on your
		Coder also providesair-gapped documentation in case you want to host it on your
		own server. The docs are exported as static files that you can host on any web
		server, as demonstrated in the example below:

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -154,9 +154,9 @@
		]
		},
		{
		"title": "Offline Deployments",
		"description": "Run Coder inoffline /air-gapped environments",
		"path": "./install/offline.md",
		"title": "Air-gapped Deployments",
		"description": "Run Coder in air-gapped / disconnected / offline environments",
		"path": "./install/airgap.md",
		"icon_path": "./images/icons/lan.svg"
		},
		{
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -332,7 +332,7 @@ References:
		## Can I run Coder in an air-gapped or offline mode? (no Internet)?

		Yes, Coder can be deployed in
		[air-gapped or offline mode](../install/offline.md).
		[air-gapped or offline mode](../install/airgap.md).

		Our product bundles with the Terraform binary so assume access to terraform.io
		during installation. The docs outline rebuilding the Coder container with
Expand Down