You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs). info

*Edge Microgateway v. 3.2.x*

This topic explains how to install or uninstall Edge Microgateway.

## Minimum hardware requirements

Edge Microgateway requires the following minimum hardware configuration:

> [!NOTE]
> Resource requirements vary greatly based on the volume and complexity of API traffic. Apigee recommends determining actual production hardware requirements in a sizing exercise that incorporates the use of simulated API traffic.

- On a virtual machine (VM), Edge Microgateway requires a minimum of 1 core and at least 256 MB of RAM. The Edge Microgateway process itself takes less than 128 MB of RAM.
- On a container, Microgateway can be used with an image size of less than 100MB.

## Prerequisites

- Apigee supports Active LTS or Maintenance LTS releases on Windows, macOS, and Linux. See [Supported software for Apigee
  Edge Microgateway](https://docs.apigee.com/release/supported-software#apigeeedgemicrogateway) for more information.
- Windows requires [OpenSSL](https://www.openssl.org/) to be installed and added to the PATH.
- If you are using Apigee Edge Private Cloud to configure with Edge Microgateway, you must be running Private Cloud version **4.18.01** or later.

## Installing Edge Microgateway if
you have an internet connection

This section explains how to install Edge Microgateway and initialize a default
configuration. If you are operating without an internet connection, see
[Can I install Edge Microgateway without an internet connection?](https://docs.apigee.com/api-platform/microgateway/3.2.x/installing-edge-microgateway#caniinstalledgemicrogatewaywithoutaninternetconnection).

1. Install the latest version of Edge Microgateway with `npm` as follows. This command installs the software and puts the `edgemicro` executable [in your path](https://docs.apigee.com/api-platform/microgateway/3.2.x/installing-edge-microgateway#whereinstalled).

   ```
   npm install edgemicro -g
   ```

   To install a specific version of Edge Microgateway, you need to specify the
   **version number** in the installation command. **If you do not specify
   the version number, the latest version will be installed.** For example, to install
   version 3.1.5, use the following command.

   ```
   npm install edgemicro@3.1.5 -g
   ```
2. Check the version number. For example, if you installed version 3.1.5:

   ```
   edgemicro --version
   current nodejs version is v12.5.0
   current edgemicro version is 3.1.5
   ```
3. Follow the setup and configuration steps in [Setting up
   and configuring Edge Microgateway](https://docs.apigee.com/api-platform/microgateway/3.2.x/setting-and-configuring-edge-microgateway).

## Upgrading Edge Microgateway


To upgrade a previously installed version of Edge Microgateway, see
[Upgrading Edge Microgateway if you have an internet connection](https://docs.apigee.com/api-platform/microgateway/3.2.x/operation-and-configuration-reference-edge-microgateway#upgradingedgemicrogateway).


Apigee recommends you test your existing configuration with
the new version before upgrading your production environment.

<br />

## Operating Edge Microgateway on Windows as a
Service

You can operate Edge Microgateway on Windows as a service. For details, see [Best practices for operational management of Microgateway (edgemicro) on Windows](https://discuss.google.dev/t/best-practices-for-operational-management-of-microgateway-edgemicro-on-windows/16817) on the
Apigee Community.

## Can I install Edge Microgateway
without an internet connection?

On sites that do not have ready internet access, it is possible for an administrator to
install and maintain a [private npm registry](https://docs.npmjs.com/misc/registry#can-i-run-my-own-private-registry)
on your internal network. Instructions for setting up a private `npm` registry are
beyond the scope of this guide; however, you can search for and find helpful instructions. With a
private `npm` registry installed, you can follow the installation or upgrade instructions given
above.

## Getting started

If you're new to Edge Microgateway, the [Setting up and
configuring Edge Microgateway](https://docs.apigee.com/api-platform/microgateway/3.2.x/setting-and-configuring-edge-microgateway) is the best place to start after you complete the
install. The setup and configuration guide covers all the steps you need to do to install,
configure, start, and use an instance of Edge Microgateway.

## Where
is Edge Microgateway installed?

When you use `npm` with the global option (`npm install -g edgemicro`),
the software is installed in `[prefix]/lib/node_modules/edgemicro`. You can find the
value of `[prefix]` with this command:

```
npm config get prefix
```

The prefix config defaults to the location where node is installed. On most systems, this is
`/usr/local`. On Windows, it's `%AppData%\npm`. The value of
`[prefix]` is configurable. See [npm-folders](https://docs.npmjs.com/files/folders) for more information about where Node.js
modules are installed by default and how to configure the installation location.

## Uninstalling Edge Microgateway

If you need to remove Edge Microgateway:

1. Delete or archive the installation directory `\[prefix\]/lib/node_modules/edgemicro`, where \[prefix\] is the npm prefix as explained in [Where is Edge Microgateway installed](https://docs.apigee.com/api-platform/microgateway/3.2.x/installing-edge-microgateway#whereisedgemicrogatewayinstalled)?
2. [Delete or archive the log files](https://docs.apigee.com/api-platform/microgateway/3.2.x/operation-and-configuration-reference-edge-microgateway#managinglogfiles). By default, `edgemicro-\*.log` files are in `/var/tmp/`, but this location is configurable. Check the Edge Microgateway configuration file if in doubt.
3. Delete or archive the runtime config and cache config files:

   ```
   ~/.edgemicro/*.yaml
   ```

## Kubernetes support

You can use Edge Microgateway to provide Apigee API management for
services running in a [Kubernetes](https://kubernetes.io/) cluster. See [Integrate Edge Microgateway with Kubernetes overview](https://docs.apigee.com/api-platform/integrations/kubernetes/k8s-introduction).

## Docker support

You can now download the latest Edge Microgateway release as a [Docker image](https://docs.docker.com/):

```
docker pull gcr.io/apigee-microgateway/edgemicro:latest
```