{"action":"created","comment":{"url":"https://api.github.com/repos/juju/docs/pulls/comments/49899966","id":49899966,"diff_hunk":"@@ -0,0 +1,204 @@\n+Title: LXD local provider\n+\n+\n+# Overview\n+\n+The LXD local provider is the most efficient and featureful way to use Juju\n+locally on Ubuntu. It leverages [LXD](https://linuxcontainers.org/lxd/) to\n+enable multiple Juju-deployed services within a single operating system.\n+Immediate uses include:\n+\n+ - Evaluation of Juju\n+ - Evaluation of deployed software\n+ - Experimentation with various service configurations\n+ - Charm development\n+\n+It is a replacement for the traditional LXC local provider and has some\n+notable differences:\n+\n+ - The state server is no longeer localhost but just another LXC container.\n+   The benefits of keeping installed software/files isolated in a container far\n+   outweigh the extra time needed to create this container.\n+ - Due to the above, superuser privileges (sudo) are no longer required.\n+ - There is no more \"Juju cache\" for images. LXD now has its own cache\n+   (`/var/lib/lxd/images`) which is separate from the traditional LXC cache\n+   (`/var/cache/lxc`).\n+\n+Although this document does provide enough information to get you running with\n+LXD itself (this document is ultimately about running LXD with Juju) it does\n+so assuming you are setting up LXD for the first time.\n+\n+**Note:** If you are running iptables (firewall) or even an iptables frontend\n+such as `ufw`, the LXD local provider might not work properly. Troubleshoot\n+accordingly or stop the firewall altogether.\n+\n+\n+# Prerequisites and installation of Juju and LXD\n+\n+ - The LXD local provider will not work on Ubuntu 12.04 LTS and backporting to\n+   Ubuntu 14.04 LTS is incomplete.\n+\n+ - Ubuntu 15.10 (Wily) or Ubuntu 16.04 LTS (Xenial) is needed.\n+\n+ - The LXD stable PPA and the Juju devel PPA (may change) are needed.\n+\n+ - Container migration (copying/moving) requires a modern version of the\n+   *criu* binary and a 4.4 Linux kernel (Xenial).\n+\n+Proceed to install the software:\n+\n+```bash\n+sudo apt-add-repository -y ppa:juju/devel\n+sudo add-apt-repository -y ppa:ubuntu-lxc/lxd-stable\n+sudo apt-get update\n+sudo apt-get install juju-local lxd\n+```\n+\n+Now either log out and log in again to get your group membership refreshed, or use:\n+\n+```bash\n+newgrp lxd\n+```\n+\n+\n+# Images\n+\n+With standalone LXD, images are available via either a local or network-based\n+store. These can be called a local image store *remote*, a **local remote**, or a\n+networked image store remote, a **non-local remote**. Juju, however, only\n+supports local remotes at this time. Images stored on them must also have the\n+names (aliases) in the format `ubuntu-<codename>` such as 'ubuntu-trusty' and\n+'ubuntu-xenial'.\n+\n+The first time an image is needed the store will supply it and any subsequent\n+requests will be satisfied by the LXD cache. In this way, a store is sollicited","path":"src/en/config-LXD.md","position":74,"original_position":74,"commit_id":"e8b18ae18a7ec21b847fb21d823afdd8855b8b6d","original_commit_id":"e8b18ae18a7ec21b847fb21d823afdd8855b8b6d","user":{"login":"mbruzek","id":6385185,"avatar_url":"https://avatars.githubusercontent.com/u/6385185?v=3","gravatar_id":"","url":"https://api.github.com/users/mbruzek","html_url":"https://github.com/mbruzek","followers_url":"https://api.github.com/users/mbruzek/followers","following_url":"https://api.github.com/users/mbruzek/following{/other_user}","gists_url":"https://api.github.com/users/mbruzek/gists{/gist_id}","starred_url":"https://api.github.com/users/mbruzek/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbruzek/subscriptions","organizations_url":"https://api.github.com/users/mbruzek/orgs","repos_url":"https://api.github.com/users/mbruzek/repos","events_url":"https://api.github.com/users/mbruzek/events{/privacy}","received_events_url":"https://api.github.com/users/mbruzek/received_events","type":"User","site_admin":false},"body":"s/sollicited/solicited/","created_at":"2016-01-15T20:16:14Z","updated_at":"2016-01-15T20:16:14Z","html_url":"https://github.com/juju/docs/pull/801#discussion_r49899966","pull_request_url":"https://api.github.com/repos/juju/docs/pulls/801","_links":{"self":{"href":"https://api.github.com/repos/juju/docs/pulls/comments/49899966"},"html":{"href":"https://github.com/juju/docs/pull/801#discussion_r49899966"},"pull_request":{"href":"https://api.github.com/repos/juju/docs/pulls/801"}}},"pull_request":{"url":"https://api.github.com/repos/juju/docs/pulls/801","id":56214620,"html_url":"https://github.com/juju/docs/pull/801","diff_url":"https://github.com/juju/docs/pull/801.diff","patch_url":"https://github.com/juju/docs/pull/801.patch","issue_url":"https://api.github.com/repos/juju/docs/issues/801","number":801,"state":"open","locked":false,"title":"2.0 lxd provider","user":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-01-15T20:02:05Z","updated_at":"2016-01-15T20:16:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5b24e899791e709947747c01bfcdd2e981945b6f","assignee":{"login":"evilnick","id":115290,"avatar_url":"https://avatars.githubusercontent.com/u/115290?v=3","gravatar_id":"","url":"https://api.github.com/users/evilnick","html_url":"https://github.com/evilnick","followers_url":"https://api.github.com/users/evilnick/followers","following_url":"https://api.github.com/users/evilnick/following{/other_user}","gists_url":"https://api.github.com/users/evilnick/gists{/gist_id}","starred_url":"https://api.github.com/users/evilnick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/evilnick/subscriptions","organizations_url":"https://api.github.com/users/evilnick/orgs","repos_url":"https://api.github.com/users/evilnick/repos","events_url":"https://api.github.com/users/evilnick/events{/privacy}","received_events_url":"https://api.github.com/users/evilnick/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/juju/docs/pulls/801/commits","review_comments_url":"https://api.github.com/repos/juju/docs/pulls/801/comments","review_comment_url":"https://api.github.com/repos/juju/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/juju/docs/issues/801/comments","statuses_url":"https://api.github.com/repos/juju/docs/statuses/e8b18ae18a7ec21b847fb21d823afdd8855b8b6d","head":{"label":"petermatulis:2.0_lxd-provider","ref":"2.0_lxd-provider","sha":"e8b18ae18a7ec21b847fb21d823afdd8855b8b6d","user":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"repo":{"id":36665444,"name":"docs","full_name":"petermatulis/docs","owner":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/petermatulis/docs","description":"Juju documentation, found online at https://jujucharms.com/docs","fork":true,"url":"https://api.github.com/repos/petermatulis/docs","forks_url":"https://api.github.com/repos/petermatulis/docs/forks","keys_url":"https://api.github.com/repos/petermatulis/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/petermatulis/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/petermatulis/docs/teams","hooks_url":"https://api.github.com/repos/petermatulis/docs/hooks","issue_events_url":"https://api.github.com/repos/petermatulis/docs/issues/events{/number}","events_url":"https://api.github.com/repos/petermatulis/docs/events","assignees_url":"https://api.github.com/repos/petermatulis/docs/assignees{/user}","branches_url":"https://api.github.com/repos/petermatulis/docs/branches{/branch}","tags_url":"https://api.github.com/repos/petermatulis/docs/tags","blobs_url":"https://api.github.com/repos/petermatulis/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/petermatulis/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/petermatulis/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/petermatulis/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/petermatulis/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/petermatulis/docs/languages","stargazers_url":"https://api.github.com/repos/petermatulis/docs/stargazers","contributors_url":"https://api.github.com/repos/petermatulis/docs/contributors","subscribers_url":"https://api.github.com/repos/petermatulis/docs/subscribers","subscription_url":"https://api.github.com/repos/petermatulis/docs/subscription","commits_url":"https://api.github.com/repos/petermatulis/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/petermatulis/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/petermatulis/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/petermatulis/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/petermatulis/docs/contents/{+path}","compare_url":"https://api.github.com/repos/petermatulis/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/petermatulis/docs/merges","archive_url":"https://api.github.com/repos/petermatulis/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/petermatulis/docs/downloads","issues_url":"https://api.github.com/repos/petermatulis/docs/issues{/number}","pulls_url":"https://api.github.com/repos/petermatulis/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/petermatulis/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/petermatulis/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/petermatulis/docs/labels{/name}","releases_url":"https://api.github.com/repos/petermatulis/docs/releases{/id}","created_at":"2015-06-01T14:18:40Z","updated_at":"2015-08-03T16:07:04Z","pushed_at":"2016-01-15T20:00:15Z","git_url":"git://github.com/petermatulis/docs.git","ssh_url":"git@github.com:petermatulis/docs.git","clone_url":"https://github.com/petermatulis/docs.git","svn_url":"https://github.com/petermatulis/docs","homepage":"","size":12674,"stargazers_count":0,"watchers_count":0,"language":"Smarty","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"juju:master","ref":"master","sha":"ecd1c7a58769e365d163d0eea2b6f69c4f5bb2b1","user":{"login":"juju","id":4604548,"avatar_url":"https://avatars.githubusercontent.com/u/4604548?v=3","gravatar_id":"","url":"https://api.github.com/users/juju","html_url":"https://github.com/juju","followers_url":"https://api.github.com/users/juju/followers","following_url":"https://api.github.com/users/juju/following{/other_user}","gists_url":"https://api.github.com/users/juju/gists{/gist_id}","starred_url":"https://api.github.com/users/juju/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juju/subscriptions","organizations_url":"https://api.github.com/users/juju/orgs","repos_url":"https://api.github.com/users/juju/repos","events_url":"https://api.github.com/users/juju/events{/privacy}","received_events_url":"https://api.github.com/users/juju/received_events","type":"Organization","site_admin":false},"repo":{"id":16817497,"name":"docs","full_name":"juju/docs","owner":{"login":"juju","id":4604548,"avatar_url":"https://avatars.githubusercontent.com/u/4604548?v=3","gravatar_id":"","url":"https://api.github.com/users/juju","html_url":"https://github.com/juju","followers_url":"https://api.github.com/users/juju/followers","following_url":"https://api.github.com/users/juju/following{/other_user}","gists_url":"https://api.github.com/users/juju/gists{/gist_id}","starred_url":"https://api.github.com/users/juju/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juju/subscriptions","organizations_url":"https://api.github.com/users/juju/orgs","repos_url":"https://api.github.com/users/juju/repos","events_url":"https://api.github.com/users/juju/events{/privacy}","received_events_url":"https://api.github.com/users/juju/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/juju/docs","description":"Juju documentation, found online at https://jujucharms.com/docs","fork":false,"url":"https://api.github.com/repos/juju/docs","forks_url":"https://api.github.com/repos/juju/docs/forks","keys_url":"https://api.github.com/repos/juju/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/juju/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/juju/docs/teams","hooks_url":"https://api.github.com/repos/juju/docs/hooks","issue_events_url":"https://api.github.com/repos/juju/docs/issues/events{/number}","events_url":"https://api.github.com/repos/juju/docs/events","assignees_url":"https://api.github.com/repos/juju/docs/assignees{/user}","branches_url":"https://api.github.com/repos/juju/docs/branches{/branch}","tags_url":"https://api.github.com/repos/juju/docs/tags","blobs_url":"https://api.github.com/repos/juju/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/juju/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/juju/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/juju/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/juju/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/juju/docs/languages","stargazers_url":"https://api.github.com/repos/juju/docs/stargazers","contributors_url":"https://api.github.com/repos/juju/docs/contributors","subscribers_url":"https://api.github.com/repos/juju/docs/subscribers","subscription_url":"https://api.github.com/repos/juju/docs/subscription","commits_url":"https://api.github.com/repos/juju/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/juju/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/juju/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/juju/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/juju/docs/contents/{+path}","compare_url":"https://api.github.com/repos/juju/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/juju/docs/merges","archive_url":"https://api.github.com/repos/juju/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/juju/docs/downloads","issues_url":"https://api.github.com/repos/juju/docs/issues{/number}","pulls_url":"https://api.github.com/repos/juju/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/juju/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/juju/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/juju/docs/labels{/name}","releases_url":"https://api.github.com/repos/juju/docs/releases{/id}","created_at":"2014-02-13T21:16:13Z","updated_at":"2016-01-14T17:21:22Z","pushed_at":"2016-01-15T20:02:05Z","git_url":"git://github.com/juju/docs.git","ssh_url":"git@github.com:juju/docs.git","clone_url":"https://github.com/juju/docs.git","svn_url":"https://github.com/juju/docs","homepage":"","size":13717,"stargazers_count":12,"watchers_count":12,"language":"Smarty","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":66,"mirror_url":null,"open_issues_count":97,"forks":66,"open_issues":97,"watchers":12,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/juju/docs/pulls/801"},"html":{"href":"https://github.com/juju/docs/pull/801"},"issue":{"href":"https://api.github.com/repos/juju/docs/issues/801"},"comments":{"href":"https://api.github.com/repos/juju/docs/issues/801/comments"},"review_comments":{"href":"https://api.github.com/repos/juju/docs/pulls/801/comments"},"review_comment":{"href":"https://api.github.com/repos/juju/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/juju/docs/pulls/801/commits"},"statuses":{"href":"https://api.github.com/repos/juju/docs/statuses/e8b18ae18a7ec21b847fb21d823afdd8855b8b6d"}}}}