Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 2.78 KB

requirements.md

File metadata and controls

60 lines (41 loc) · 2.78 KB

npm On-Site Prerequisites

To install the latest version of npm On-Site, you need a server fulfilling these basic specs:

  • 64-bit architecture
  • Kernel version 3.10 or higher
  • One of the following Linux flavors (see note on supported platforms below):
    • Ubuntu 14.04 / 15.10
    • CentOS 7.x
    • RHEL 7.x
    • Debian 7.7
  • Any number of CPUs/cores
  • At least 4 GB of memory/RAM
  • At least 10 GB of disk space (see note on disk space below)
  • Ports opened for inbound TCP traffic:
    • 8800 (admin console)
    • 8080 (registry)
    • 8081 (website)
    • 8082 (auth endpoints)
  • Access to the public internet, either directly or via proxy

If using Amazon Web Services, see note on AWS below.

Note on Supported Platforms

We have tested extensively on the operating systems listed above. It may be possible to run npm On-Site on other systems, but, at this time, no other systems are officially supported.

We do our best to support as many systems as possible. If you have special requirements or feedback for other platforms, please reach out to us at [email protected]. We'd love to work with you.

You can also check for system issues on the npmo-installer GitHub repo.

Note on Disk Space

The amount of disk space needed is directly proportional to the number and size of packages your registry will need to host.

For example, the full public registry hosts at least 200,000 packages with an average of 6 versions each, and this requires at least half a terabyte of storage. Smaller registries, however, can get away with just a few gigabytes.

Therefore, a server with 50 - 100 GB is a good choice for most registries.

Please reserve at least 6 GB for OS resources and npm On-Site appliance containers.

Once installed, you can configure where registry data is stored on your server via the "Storage" paths on the "Settings" page of the admin web console (port 8800). For details on configuring your On-Site instance, please see this page.

Note on AWS

We recommend using an m3.large instance type.

If extra storage is needed, you may want to attach an EBS volume to your EC2 instance and configure the "Storage" paths on your On-Site appliance to use directories under the mount point.

To open ports on your AWS EC2 instance, you can define a Security Group with the following Inbound settings:

AWS Security Group