---
# System prepended metadata

title: Verdaccio Installation Guide

---

# Verdaccio Installation Guide

Verdaccio is a lightweight, private npm registry that allows developers to host and manage their own npm packages. It is an open-source project, and can be easily installed and configured on your own server.

## Prerequisites
Before you begin, you will need to have the following installed on your server:

- Node.js (version 10 or later)
- npm (version 6 or later)

## Installation
To install Verdaccio, you can use npm by running the following command:

```npm
npm install -g verdaccio
```
This will install Verdaccio globally on your system, making it available as a command-line tool.

## Configuration
Once Verdaccio is installed, you will need to create a configuration file in order to customize how it behaves. You can create a new configuration file by running the following command:

```
verdaccio --config my-config.yaml
```
This will create a new file called `my-config.yaml` in the current directory.
You can edit this file to customize various settings, such as the port number that Verdaccio will run on, and the location of the storage directory.

## Running Verdaccio
To start Verdaccio, you can simply run the following command:

```
verdaccio
```

This will start the Verdaccio server using the default configuration.
You can also specify a different configuration file by running:

```
verdaccio --config my-config.yaml
```

Once the server is running, you can access the web interface by navigating to http://localhost:4873 in your web browser.

## Conclusion
That's it! You have successfully installed and configured Verdaccio. You can now use it to host and manage your own npm packages, or to proxy and cache packages from the official npm registry. Feel free to explore the various configuration options and settings to customize Verdaccio to your needs.