{"action":"created","comment":{"url":"https://api.github.com/repos/resin-io/docs/pulls/comments/47145035","id":47145035,"diff_hunk":"@@ -1,6 +1,60 @@\n-# Wifi Guide\n+# Network Setup\n \n-## Connecting a Device to WiFi\n+* [Introduction](/pages/deployment/wifi.md#introduction)\n+* [Network Requirements](/pages/deployment/wifi.md#network-requirements)\n+* [Ethernet Connections](/pages/deployment/wifi.md#ethernet-connections)\n+* [Wifi Connections](/pages/deployment/wifi.md#wifi-connections)\n+* [3G or Cellular Connections](/pages/deployment/wifi.md#3g-or-cellular-connections)\n+* [Captive Portal Network Setup](/pages/deployment/wifi.md#captive-portal-network-setup)\n+\n+## Introduction\n+\n+In order to deploy code to your device(s), they will need to be connected to the internet in some shape or form. The resin.io HostOS manages your devices' network connection with [ConnMan][connman], an open source connection manager.\n+\n+Currently all resin.io devices are configured to favour [ethernet](/pages/deployment/wifi.md#ethernet-connections) and will automatically use this connection type if it is available. You can define all manner of network configurations using [Connman][connman], for example [setting a static IP](/pages/deployment/wifi.md#set-static-ip).\n+\n+## Network Requirements\n+\n+In order for a resin.io device to get outside of the local network and connect to the resin.io API, there are a few core network requirements.\n+\n+Resin.io makes use of the following ports:\n+\n+* `443` TCP - This is the most fundamental requirement - it is used to connect to the VPN and the web terminal, and many web endpoints using TLS (https://.)\n+* `123` UDP - For NTP time synchronisation.\n+* `53` UDP - For DNS name resolution.\n+\n+Each of these should work with outward only (and inward once outward connection established) firewall settings.\n+\n+Additionally, if the network your device is connecting to works with whitelisting, you should whitelist the following domains on Port `80` and `443`:\n+* `*.resin.io`\n+* `*.pubnub.com`\n+* `*.ngrok.com`\n+* `*.ngrok.io`\n+","path":"pages/deployment/wifi.md","position":35,"original_position":35,"commit_id":"b0efc40256d0ebf4dccbd69a869e4c2453292885","original_commit_id":"b0efc40256d0ebf4dccbd69a869e4c2453292885","user":{"login":"lifeeth","id":19370,"avatar_url":"https://avatars.githubusercontent.com/u/19370?v=3","gravatar_id":"","url":"https://api.github.com/users/lifeeth","html_url":"https://github.com/lifeeth","followers_url":"https://api.github.com/users/lifeeth/followers","following_url":"https://api.github.com/users/lifeeth/following{/other_user}","gists_url":"https://api.github.com/users/lifeeth/gists{/gist_id}","starred_url":"https://api.github.com/users/lifeeth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lifeeth/subscriptions","organizations_url":"https://api.github.com/users/lifeeth/orgs","repos_url":"https://api.github.com/users/lifeeth/repos","events_url":"https://api.github.com/users/lifeeth/events{/privacy}","received_events_url":"https://api.github.com/users/lifeeth/received_events","type":"User","site_admin":false},"body":"We also make outgoing connection to mixpanel - though not a requirement - it will show up in their logs.","created_at":"2015-12-09T20:12:46Z","updated_at":"2015-12-09T20:12:46Z","html_url":"https://github.com/resin-io/docs/pull/121#discussion_r47145035","pull_request_url":"https://api.github.com/repos/resin-io/docs/pulls/121","_links":{"self":{"href":"https://api.github.com/repos/resin-io/docs/pulls/comments/47145035"},"html":{"href":"https://github.com/resin-io/docs/pull/121#discussion_r47145035"},"pull_request":{"href":"https://api.github.com/repos/resin-io/docs/pulls/121"}}},"pull_request":{"url":"https://api.github.com/repos/resin-io/docs/pulls/121","id":53152682,"html_url":"https://github.com/resin-io/docs/pull/121","diff_url":"https://github.com/resin-io/docs/pull/121.diff","patch_url":"https://github.com/resin-io/docs/pull/121.patch","issue_url":"https://api.github.com/repos/resin-io/docs/issues/121","number":121,"state":"open","locked":false,"title":"updated information on network, moved supported wifi adapters to hard…","user":{"login":"shaunmulligan","id":3915043,"avatar_url":"https://avatars.githubusercontent.com/u/3915043?v=3","gravatar_id":"","url":"https://api.github.com/users/shaunmulligan","html_url":"https://github.com/shaunmulligan","followers_url":"https://api.github.com/users/shaunmulligan/followers","following_url":"https://api.github.com/users/shaunmulligan/following{/other_user}","gists_url":"https://api.github.com/users/shaunmulligan/gists{/gist_id}","starred_url":"https://api.github.com/users/shaunmulligan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shaunmulligan/subscriptions","organizations_url":"https://api.github.com/users/shaunmulligan/orgs","repos_url":"https://api.github.com/users/shaunmulligan/repos","events_url":"https://api.github.com/users/shaunmulligan/events{/privacy}","received_events_url":"https://api.github.com/users/shaunmulligan/received_events","type":"User","site_admin":false},"body":"…ware section","created_at":"2015-12-09T17:41:41Z","updated_at":"2015-12-09T20:12:46Z","closed_at":null,"merged_at":null,"merge_commit_sha":"323fefbc2e572dd710fee23cc0216ff296754639","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/resin-io/docs/pulls/121/commits","review_comments_url":"https://api.github.com/repos/resin-io/docs/pulls/121/comments","review_comment_url":"https://api.github.com/repos/resin-io/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/resin-io/docs/issues/121/comments","statuses_url":"https://api.github.com/repos/resin-io/docs/statuses/b0efc40256d0ebf4dccbd69a869e4c2453292885","head":{"label":"resin-io:add/network-needs","ref":"add/network-needs","sha":"b0efc40256d0ebf4dccbd69a869e4c2453292885","user":{"login":"resin-io","id":6157842,"avatar_url":"https://avatars.githubusercontent.com/u/6157842?v=3","gravatar_id":"","url":"https://api.github.com/users/resin-io","html_url":"https://github.com/resin-io","followers_url":"https://api.github.com/users/resin-io/followers","following_url":"https://api.github.com/users/resin-io/following{/other_user}","gists_url":"https://api.github.com/users/resin-io/gists{/gist_id}","starred_url":"https://api.github.com/users/resin-io/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/resin-io/subscriptions","organizations_url":"https://api.github.com/users/resin-io/orgs","repos_url":"https://api.github.com/users/resin-io/repos","events_url":"https://api.github.com/users/resin-io/events{/privacy}","received_events_url":"https://api.github.com/users/resin-io/received_events","type":"Organization","site_admin":false},"repo":{"id":21133508,"name":"docs","full_name":"resin-io/docs","owner":{"login":"resin-io","id":6157842,"avatar_url":"https://avatars.githubusercontent.com/u/6157842?v=3","gravatar_id":"","url":"https://api.github.com/users/resin-io","html_url":"https://github.com/resin-io","followers_url":"https://api.github.com/users/resin-io/followers","following_url":"https://api.github.com/users/resin-io/following{/other_user}","gists_url":"https://api.github.com/users/resin-io/gists{/gist_id}","starred_url":"https://api.github.com/users/resin-io/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/resin-io/subscriptions","organizations_url":"https://api.github.com/users/resin-io/orgs","repos_url":"https://api.github.com/users/resin-io/repos","events_url":"https://api.github.com/users/resin-io/events{/privacy}","received_events_url":"https://api.github.com/users/resin-io/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/resin-io/docs","description":"Documentation for the resin.io platform.","fork":false,"url":"https://api.github.com/repos/resin-io/docs","forks_url":"https://api.github.com/repos/resin-io/docs/forks","keys_url":"https://api.github.com/repos/resin-io/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/resin-io/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/resin-io/docs/teams","hooks_url":"https://api.github.com/repos/resin-io/docs/hooks","issue_events_url":"https://api.github.com/repos/resin-io/docs/issues/events{/number}","events_url":"https://api.github.com/repos/resin-io/docs/events","assignees_url":"https://api.github.com/repos/resin-io/docs/assignees{/user}","branches_url":"https://api.github.com/repos/resin-io/docs/branches{/branch}","tags_url":"https://api.github.com/repos/resin-io/docs/tags","blobs_url":"https://api.github.com/repos/resin-io/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/resin-io/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/resin-io/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/resin-io/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/resin-io/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/resin-io/docs/languages","stargazers_url":"https://api.github.com/repos/resin-io/docs/stargazers","contributors_url":"https://api.github.com/repos/resin-io/docs/contributors","subscribers_url":"https://api.github.com/repos/resin-io/docs/subscribers","subscription_url":"https://api.github.com/repos/resin-io/docs/subscription","commits_url":"https://api.github.com/repos/resin-io/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/resin-io/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/resin-io/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/resin-io/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/resin-io/docs/contents/{+path}","compare_url":"https://api.github.com/repos/resin-io/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/resin-io/docs/merges","archive_url":"https://api.github.com/repos/resin-io/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/resin-io/docs/downloads","issues_url":"https://api.github.com/repos/resin-io/docs/issues{/number}","pulls_url":"https://api.github.com/repos/resin-io/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/resin-io/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/resin-io/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/resin-io/docs/labels{/name}","releases_url":"https://api.github.com/repos/resin-io/docs/releases{/id}","created_at":"2014-06-23T16:26:36Z","updated_at":"2015-10-06T21:08:43Z","pushed_at":"2015-12-09T19:58:31Z","git_url":"git://github.com/resin-io/docs.git","ssh_url":"git@github.com:resin-io/docs.git","clone_url":"https://github.com/resin-io/docs.git","svn_url":"https://github.com/resin-io/docs","homepage":null,"size":55744,"stargazers_count":4,"watchers_count":4,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":22,"mirror_url":null,"open_issues_count":11,"forks":22,"open_issues":11,"watchers":4,"default_branch":"gh-pages"}},"base":{"label":"resin-io:gh-pages","ref":"gh-pages","sha":"546cf773c2e706739be013f43738d7dce7fe34a3","user":{"login":"resin-io","id":6157842,"avatar_url":"https://avatars.githubusercontent.com/u/6157842?v=3","gravatar_id":"","url":"https://api.github.com/users/resin-io","html_url":"https://github.com/resin-io","followers_url":"https://api.github.com/users/resin-io/followers","following_url":"https://api.github.com/users/resin-io/following{/other_user}","gists_url":"https://api.github.com/users/resin-io/gists{/gist_id}","starred_url":"https://api.github.com/users/resin-io/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/resin-io/subscriptions","organizations_url":"https://api.github.com/users/resin-io/orgs","repos_url":"https://api.github.com/users/resin-io/repos","events_url":"https://api.github.com/users/resin-io/events{/privacy}","received_events_url":"https://api.github.com/users/resin-io/received_events","type":"Organization","site_admin":false},"repo":{"id":21133508,"name":"docs","full_name":"resin-io/docs","owner":{"login":"resin-io","id":6157842,"avatar_url":"https://avatars.githubusercontent.com/u/6157842?v=3","gravatar_id":"","url":"https://api.github.com/users/resin-io","html_url":"https://github.com/resin-io","followers_url":"https://api.github.com/users/resin-io/followers","following_url":"https://api.github.com/users/resin-io/following{/other_user}","gists_url":"https://api.github.com/users/resin-io/gists{/gist_id}","starred_url":"https://api.github.com/users/resin-io/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/resin-io/subscriptions","organizations_url":"https://api.github.com/users/resin-io/orgs","repos_url":"https://api.github.com/users/resin-io/repos","events_url":"https://api.github.com/users/resin-io/events{/privacy}","received_events_url":"https://api.github.com/users/resin-io/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/resin-io/docs","description":"Documentation for the resin.io platform.","fork":false,"url":"https://api.github.com/repos/resin-io/docs","forks_url":"https://api.github.com/repos/resin-io/docs/forks","keys_url":"https://api.github.com/repos/resin-io/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/resin-io/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/resin-io/docs/teams","hooks_url":"https://api.github.com/repos/resin-io/docs/hooks","issue_events_url":"https://api.github.com/repos/resin-io/docs/issues/events{/number}","events_url":"https://api.github.com/repos/resin-io/docs/events","assignees_url":"https://api.github.com/repos/resin-io/docs/assignees{/user}","branches_url":"https://api.github.com/repos/resin-io/docs/branches{/branch}","tags_url":"https://api.github.com/repos/resin-io/docs/tags","blobs_url":"https://api.github.com/repos/resin-io/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/resin-io/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/resin-io/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/resin-io/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/resin-io/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/resin-io/docs/languages","stargazers_url":"https://api.github.com/repos/resin-io/docs/stargazers","contributors_url":"https://api.github.com/repos/resin-io/docs/contributors","subscribers_url":"https://api.github.com/repos/resin-io/docs/subscribers","subscription_url":"https://api.github.com/repos/resin-io/docs/subscription","commits_url":"https://api.github.com/repos/resin-io/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/resin-io/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/resin-io/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/resin-io/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/resin-io/docs/contents/{+path}","compare_url":"https://api.github.com/repos/resin-io/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/resin-io/docs/merges","archive_url":"https://api.github.com/repos/resin-io/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/resin-io/docs/downloads","issues_url":"https://api.github.com/repos/resin-io/docs/issues{/number}","pulls_url":"https://api.github.com/repos/resin-io/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/resin-io/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/resin-io/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/resin-io/docs/labels{/name}","releases_url":"https://api.github.com/repos/resin-io/docs/releases{/id}","created_at":"2014-06-23T16:26:36Z","updated_at":"2015-10-06T21:08:43Z","pushed_at":"2015-12-09T19:58:31Z","git_url":"git://github.com/resin-io/docs.git","ssh_url":"git@github.com:resin-io/docs.git","clone_url":"https://github.com/resin-io/docs.git","svn_url":"https://github.com/resin-io/docs","homepage":null,"size":55744,"stargazers_count":4,"watchers_count":4,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":22,"mirror_url":null,"open_issues_count":11,"forks":22,"open_issues":11,"watchers":4,"default_branch":"gh-pages"}},"_links":{"self":{"href":"https://api.github.com/repos/resin-io/docs/pulls/121"},"html":{"href":"https://github.com/resin-io/docs/pull/121"},"issue":{"href":"https://api.github.com/repos/resin-io/docs/issues/121"},"comments":{"href":"https://api.github.com/repos/resin-io/docs/issues/121/comments"},"review_comments":{"href":"https://api.github.com/repos/resin-io/docs/pulls/121/comments"},"review_comment":{"href":"https://api.github.com/repos/resin-io/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/resin-io/docs/pulls/121/commits"},"statuses":{"href":"https://api.github.com/repos/resin-io/docs/statuses/b0efc40256d0ebf4dccbd69a869e4c2453292885"}}}}