Installing the server

npmE runs locally, on a server you control, with no external dependencies. Many organizations want this for security, regulatory, or operational reasons.

Server setup

Follow the instructions in the quickstart video, or do the following:

Sign up for a trial license for npm Enterprise. Make sure you have a machine that meets the installation requirements. It can also be run in a Docker container. On the server, run npm install npme. Do NOT run using sudo. The installation process will require your billing email and the license key you received during signup.

Installation questions

The npme installer will ask you a series of questions as it configures your machine.

[sudo] password for user Your system is requesting the system admin password. The installer must run as root. this will install npmE on the server (you should only run this on a dedicated machine), continue? The installer assumes npm Enterprise (npmE) is the only service running on the machine. If you have other services that use the same ports as npmE you may run into errors. enter your billing email This is the email address you used to sign up for the trial. It does not need to be an npm user. enter your license key You received this via email when you signed up for the trial. It looks like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. full URL of front-facing host that npm Enterprise will run on. Include 'http' and ':8080' This URL needs to be accessible from your users' machines and also accessible to the appliance itself. It must include the port number, e.g. http://registry.example.com:8080 path to package whitelist used by public registry follower The location of the whitelist file. This defaults to /etc/npme/whitelist and you should not need to change this. full URL of your GitHub Enterprise appliance The URL of your GitHub Enterprise appliance. This defaults to using GitHub itself. folder on HD to store package binaries The location to store the npm Enterprise binaries. This defaults to /etc/npme/packages and you should not need to change this.