diff --git a/docs/_redirects b/docs/_redirects new file mode 100644 index 0000000000000..fdfc401f098f9 --- /dev/null +++ b/docs/_redirects @@ -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 diff --git a/docs/admin/integrations/index.md b/docs/admin/integrations/index.md index 900925bd2dfd0..3a1a11f2448df 100644 --- a/docs/admin/integrations/index.md +++ b/docs/admin/integrations/index.md @@ -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 Coder offline](../../install/offline.md) +- [Deploy Coder Air-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 index 702bce2599266..06f0bc670fad8 100644 --- a/docs/admin/integrations/jfrog-artifactory.md +++ b/docs/admin/integrations/jfrog-artifactory.md @@ -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 diff --git a/docs/admin/networking/index.md b/docs/admin/networking/index.md index 4ab3352b2c19f..87cbcd7775c93 100644 --- a/docs/admin/networking/index.md +++ b/docs/admin/networking/index.md @@ -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 @@ -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 for offline deployments, you may run custom DERP servers. Refer to +relays for air-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 index a37997f942f23..5e06e5a028c3c 100644 --- a/docs/changelogs/v0.27.0.md +++ b/docs/changelogs/v0.27.0.md @@ -25,7 +25,7 @@ Agent logs can be pushed after a workspace has started (#8528) - Template version messages (#8435) 252772262-087f1338-f1e2-49fb-81f2-358070a46484 - 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 index e7804ab57b3db..1b17ba3a7343f 100644 --- a/docs/changelogs/v2.8.0.md +++ b/docs/changelogs/v2.8.0.md @@ -83,7 +83,7 @@ ### Documentation -- Using coder modules in offline deployments (#11788) (@matifali) +- Using coder modules in air-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 b/docs/install/airgap.md similarity index 97% rename from docs/install/offline.md rename to docs/install/airgap.md index 289780526f76a..cb2f2340a63cd 100644 --- a/docs/install/offline.md +++ b/docs/install/airgap.md @@ -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 | @@ -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 @@ -214,9 +212,9 @@ coder: -## Offline docs +## Air-gapped docs -Coder also provides offline documentation in case you want to host it on your +Coder also provides air-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 index d2cd11ace699b..9359fb6f1da33 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -154,9 +154,9 @@ ] }, { - "title": "Offline Deployments", - "description": "Run Coder in offline / 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 index bd386f81288a8..a2f350b45a734 100644 --- a/docs/tutorials/faqs.md +++ b/docs/tutorials/faqs.md @@ -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