From 1f598cfe8fc5577b5fdbe4573f17d8cb0bf866a9 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Thu, 2 Jul 2020 11:05:18 -0600 Subject: [PATCH] updated urls doc with custom url instructions --- content/v2.0/reference/urls.md | 41 ++++++++++++++++++++++++++-------- 1 file changed, 32 insertions(+), 9 deletions(-) diff --git a/content/v2.0/reference/urls.md b/content/v2.0/reference/urls.md index 738cd6b58..9b08c821f 100644 --- a/content/v2.0/reference/urls.md +++ b/content/v2.0/reference/urls.md @@ -12,15 +12,6 @@ menu: InfluxDB 2.0 is available both locally (OSS) or on multiple cloud providers in multiple regions (Cloud). -## InfluxDB OSS URL - -For InfluxDB OSS, the default URL is the following: - -{{< keep-url >}} -``` -http://localhost:9999/ -``` - ## InfluxDB Cloud URLs Each region has a unique InfluxDB Cloud URL and API endpoint. @@ -29,3 +20,35 @@ Use the URLs below to interact with your InfluxDB Cloud instances with the [`influx` CLI](/v2.0/reference/cli/influx/), or [Telegraf](/v2.0/write-data/use-telegraf/). {{< cloud_regions >}} + +## InfluxDB OSS URLs + +For InfluxDB OSS, the default URL is the following: + +{{< keep-url >}} +``` +http://localhost:9999/ +``` + +### Customize your InfluxDB OSS URL +To customize your InfluxDB host and port, use the +[`http-bind-address` configuration option](/v2.0/reference/config-options/#http-bind-address) +when starting `influxd`. + +```sh +# Syntax +influxd --http-bind-adress : + +# Example - Run InfluxDB at http://example.com:8080 +influxd --http-bind-address example.com:8080 + +# Example - Run InfluxDB at http://localhost:8080 +influxd --http-bind-address :8080 +``` + +{{% note %}} +#### Configure DNS Routing +You must configure DNS routing to successfully route requests to your custom hostname. +Methods for configuring DNS routing vary depending on your operating system and +network architecture and are not covered in this documentation. +{{% /note %}}