{"action":"created","issue":{"url":"https://api.github.com/repos/npm/docs/issues/88","labels_url":"https://api.github.com/repos/npm/docs/issues/88/labels{/name}","comments_url":"https://api.github.com/repos/npm/docs/issues/88/comments","events_url":"https://api.github.com/repos/npm/docs/issues/88/events","html_url":"https://github.com/npm/docs/issues/88","id":51634408,"number":88,"title":"npme: \"Using npm Enterprise\" is totally unclear","user":{"login":"evil-shrike","id":1203230,"avatar_url":"https://avatars.githubusercontent.com/u/1203230?v=3","gravatar_id":"","url":"https://api.github.com/users/evil-shrike","html_url":"https://github.com/evil-shrike","followers_url":"https://api.github.com/users/evil-shrike/followers","following_url":"https://api.github.com/users/evil-shrike/following{/other_user}","gists_url":"https://api.github.com/users/evil-shrike/gists{/gist_id}","starred_url":"https://api.github.com/users/evil-shrike/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/evil-shrike/subscriptions","organizations_url":"https://api.github.com/users/evil-shrike/orgs","repos_url":"https://api.github.com/users/evil-shrike/repos","events_url":"https://api.github.com/users/evil-shrike/events{/privacy}","received_events_url":"https://api.github.com/users/evil-shrike/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/npm/docs/labels/content","name":"content","color":"207de5"},{"url":"https://api.github.com/repos/npm/docs/labels/on-site","name":"on-site","color":"bfdadc"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":11,"created_at":"2014-12-11T01:24:16Z","updated_at":"2015-11-11T18:44:48Z","closed_at":null,"body":"I've installed npme. Run it. Opened \"http://localhost:8080/\" in my browser and see some json. Nice. What next?\r\n\r\nLooking at https://docs.npmjs.com/enterprise/using-it and see nothing that helps.\r\n\r\n> Get the latest npm client\r\n\r\nIt's mentioned already on Installation page\r\n\r\nNext\r\n>Authenticating\r\n>Once you have an up-to-date client, log in to your registry using your GitHub or GitHub Enterprise credentials\r\n\r\nMmm.. Why? As I understand `npm login` is needed to automatically pick right registry for a scope. But is npme only for scoped packages? I hope it's not.\r\nFirst thing I'd try (and did) is to try to install a public package via my npmE:\r\n`npm install -g grunt-cli --registry=http://localhost:8080\"`\r\nbut.. it doesn't work (\"Package not found : grunt-cli\") ! \r\nSo probably npmE doesn't proxy public npmjs.org by default. How to make it? Probably we need some configuration. Let's look into /etc/npme/ folder. Hurray, there's `service.json` file looking like a config file. \r\nInside service.json I can see something looking like modules and options. Should it mentioned in the docs?\r\nModule 'policy-follower' is probably what I need for replicating public npm. Looking in readme.md of \\@npm/node-modules/policy-follower doesn't help at all. How to configure it?\r\n\r\nNext topics \"installing\", \"requiring\" and \"publishing\" talk about only scoped packaged. Why? It looks like npme can be used only for scoped packaged.\r\n\r\nSo I'd put info in the following order:\r\n\r\n1. how to install a public package (grunt-cli, bower, etc) via npme.\r\nprofit - caching, fault tolerance\r\nDocument: Specifiing --registry in `npm install`, setting the npmE to replicating all (or only some) packages.\r\n\r\n2. how to put a package into npme\r\nProfit: sharing a package among enterprise.\r\nRecommend: use scoped packages as they can be easily installed from npme without specifing `--registry` - put a reference to https://docs.npmjs.com/misc/scope\r\nAnyway to publish a package (scoped or not) we should authenticate ourselves:\r\n\r\n* how to do it for client (probably `npm adduser` or `npm login`?)\r\n* how to do it for server npme - how? Npme is configured to use Github. But obviously we wont allow all github users to publish packages into our private registry. So how to limit to particular users?\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/npm/docs/issues/comments/155873683","html_url":"https://github.com/npm/docs/issues/88#issuecomment-155873683","issue_url":"https://api.github.com/repos/npm/docs/issues/88","id":155873683,"user":{"login":"kevinSuttle","id":95672,"avatar_url":"https://avatars.githubusercontent.com/u/95672?v=3","gravatar_id":"","url":"https://api.github.com/users/kevinSuttle","html_url":"https://github.com/kevinSuttle","followers_url":"https://api.github.com/users/kevinSuttle/followers","following_url":"https://api.github.com/users/kevinSuttle/following{/other_user}","gists_url":"https://api.github.com/users/kevinSuttle/gists{/gist_id}","starred_url":"https://api.github.com/users/kevinSuttle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kevinSuttle/subscriptions","organizations_url":"https://api.github.com/users/kevinSuttle/orgs","repos_url":"https://api.github.com/users/kevinSuttle/repos","events_url":"https://api.github.com/users/kevinSuttle/events{/privacy}","received_events_url":"https://api.github.com/users/kevinSuttle/received_events","type":"User","site_admin":false},"created_at":"2015-11-11T18:44:48Z","updated_at":"2015-11-11T18:44:48Z","body":"So, a few things I'm noticing during the install. \r\n\r\n1. The instructions on the [docs page](https://docs.npmjs.com/enterprise/intro) and the instructions in the CLI after the install are not 1:1. In fact, they're pretty different. \r\n\r\n```bash\r\nCongrats! Your npm on-site server is now up and running \\o/\r\n\r\nThere are just a few final steps:\r\n\r\nStep 1. Access your server via HTTPS on port 8800\r\nStep 2. Proceed passed the HTTPS connection security warning (a selfsigned cert is being used initially)\r\nStep 3. Upload a custom TLS/SSL cert/key or proceed with the provided self-signed pair.\r\nStep 4. Configure your npm instance & click \"Save\".\r\nStep 5. Visit https://docs.npmjs.com/, for information about using npm on-site or contact support@npmjs.com\r\n\r\nroot@kevin-test:~# npme start\r\nNo command 'npme' found, did you mean:\r\n Command 'npm' from package 'npm' (universe)\r\nnpme: command not found\r\n```\r\n\r\n2. I was not prompted for [any input](https://docs.npmjs.com/enterprise/installation#installation-questions) during the install, so I can't access my server on port `8800`. I feel like [this config section](https://docs.npmjs.com/enterprise/intro#configuring-the-client) should be listed first. \r\n\r\n3. "}}