{"__v":0,"_id":"588f722bbcace50f0052b9f6","category":{"version":"588f722bbcace50f0052b9e1","project":"565f5fa26bafd40d0030a064","_id":"588f722bbcace50f0052b9e3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-09T21:22:52.427Z","from_sync":false,"order":1,"slug":"user-guide","title":"Reference"},"parentDoc":null,"project":"565f5fa26bafd40d0030a064","user":"565f3941ea46251700972783","version":{"__v":1,"_id":"588f722bbcace50f0052b9e1","project":"565f5fa26bafd40d0030a064","createdAt":"2017-01-30T17:04:43.410Z","releaseDate":"2017-01-30T17:04:43.410Z","categories":["588f722bbcace50f0052b9e2","588f722bbcace50f0052b9e3","588f722bbcace50f0052b9e4","588f722bbcace50f0052b9e5","588f722bbcace50f0052b9e6","588f722bbcace50f0052b9e7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"5.3.0","version":"5.3.0"},"updates":["57e551d96dec2419008de5e0","57ea89ac7728c8220022bff7"],"next":{"pages":[],"description":""},"createdAt":"2015-12-17T19:44:32.488Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"Hosts are used to map incoming requests to the appropriate API to avoid API specific path prefixes. Host names must be unique across all APIs defined in the system. At least one host should exist for every API if you would like that API to be publicly available. Each new API should get an auto-generated host by default. It will look something like: <word>-<word>-<number>.nanoscale.io.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/PCV2X1cDRey8R18pd4M9_hosts.png\",\n        \"hosts.png\",\n        \"1449\",\n        \"622\",\n        \"#5d85b2\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n## Host Properties\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**Name**\",\n    \"1-0\": \"**Hostname**\",\n    \"0-1\": \"Name for your Host (this is a required field).\",\n    \"1-1\": \"Hostname that maps to the IP address of the nanoscale.io server (this is a required field).\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\nAfter saving a new Host, you can drill into the name or hover over the row and click the pencil icon to edit it.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/yHrcaQOQlGpKEO5elfao_user-guide-environments-edit-environment-icon.png\",\n        \"user-guide-environments-edit-environment-icon.png\",\n        \"1280\",\n        \"52\",\n        \"#fca66b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nYou can use Hosts to enable custom domains on your APIs. Simply enter the unique hostname you wish to use and then at your DNS provider, point that new hostname via a CNAME entry to the default host that was provided. We do not currently offer custom SSL support at this time.","excerpt":"","slug":"hosts","type":"basic","title":"Hosts"}
Hosts are used to map incoming requests to the appropriate API to avoid API specific path prefixes. Host names must be unique across all APIs defined in the system. At least one host should exist for every API if you would like that API to be publicly available. Each new API should get an auto-generated host by default. It will look something like: <word>-<word>-<number>.nanoscale.io. [block:image] { "images": [ { "image": [ "https://files.readme.io/PCV2X1cDRey8R18pd4M9_hosts.png", "hosts.png", "1449", "622", "#5d85b2", "" ] } ] } [/block] ## Host Properties [block:parameters] { "data": { "h-0": "Property", "h-1": "Description", "0-0": "**Name**", "1-0": "**Hostname**", "0-1": "Name for your Host (this is a required field).", "1-1": "Hostname that maps to the IP address of the nanoscale.io server (this is a required field)." }, "cols": 2, "rows": 2 } [/block] After saving a new Host, you can drill into the name or hover over the row and click the pencil icon to edit it. [block:image] { "images": [ { "image": [ "https://files.readme.io/yHrcaQOQlGpKEO5elfao_user-guide-environments-edit-environment-icon.png", "user-guide-environments-edit-environment-icon.png", "1280", "52", "#fca66b", "" ] } ] } [/block] You can use Hosts to enable custom domains on your APIs. Simply enter the unique hostname you wish to use and then at your DNS provider, point that new hostname via a CNAME entry to the default host that was provided. We do not currently offer custom SSL support at this time.