﻿---
title: Offline Plugin Management
description: The Logstash plugin manager provides support for preparing offline plugin packs that you can use to install Logstash plugins on systems that don’t have...
url: https://www.elastic.co/elastic/docs-builder/docs/2585/reference/logstash/offline-plugins
products:
  - Logstash
---

# Offline Plugin Management
The Logstash [plugin manager](https://www.elastic.co/elastic/docs-builder/docs/2585/reference/logstash/working-with-plugins) provides support for preparing offline plugin packs that you can use to install Logstash plugins on systems that don’t have Internet access.
This procedure requires a staging machine running Logstash that has access to a public or [private Rubygems](https://www.elastic.co/elastic/docs-builder/docs/2585/reference/logstash/private-rubygem) server. The staging machine downloads and packages all the files and dependencies required for offline installation.

## Building Offline Plugin Packs

An *offline plugin pack* is a compressed file that contains all the plugins your offline Logstash installation requires, along with the dependencies for those plugins.
To build an offline plugin pack:
1. Make sure all the plugins that you want to package are installed on the staging server and that the staging server can access the Internet.
2. Run the `bin/logstash-plugin prepare-offline-pack` subcommand to package the plugins and dependencies:
   ```shell
   bin/logstash-plugin prepare-offline-pack --output OUTPUT --overwrite [PLUGINS]
   ```
   where:
   - `OUTPUT` specifies the zip file where the compressed plugin pack will be written. The default file is `/LOGSTASH_HOME/logstash-offline-plugins-9.0.0.zip`. If you are using 5.2.x and 5.3.0, this location should be a zip file whose contents will be overwritten.
- `[PLUGINS]` specifies one or more plugins that you want to include in the pack.
- `--overwrite` specifies if you want to override an existing file at the location

Examples:
```sh
bin/logstash-plugin prepare-offline-pack logstash-input-beats 
bin/logstash-plugin prepare-offline-pack logstash-filter-* 
bin/logstash-plugin prepare-offline-pack logstash-filter-* logstash-input-beats 
```

<note>
  Downloading all dependencies for the specified plugins may take some time, depending on the plugins listed.
</note>


## Installing Offline Plugin Packs

To install an offline plugin pack:
1. Move the compressed bundle to the machine where you want to install the plugins.
2. Run the `bin/logstash-plugin install` subcommand and pass in the file URI of the offline plugin pack.
   ```sh
   bin/logstash-plugin install file:///c:/path/to/logstash-offline-plugins-9.0.0.zip
   ```
   ```sh
   bin/logstash-plugin install file:///path/to/logstash-offline-plugins-9.0.0.zip
   ```
   This command expects a file URI, so make sure you use forward slashes and specify the full path to the pack.


## Updating Offline Plugins

To update offline plugins, you update the plugins on the staging server and then use the same process that you followed to build and install the plugin pack:
1. On the staging server, run the `bin/logstash-plugin update` subcommand to update the plugins. See [Updating plugins](/elastic/docs-builder/docs/2585/reference/logstash/working-with-plugins#updating-plugins).
2. Create a new version of the plugin pack. See [Building Offline Plugin Packs](#building-offline-packs).
3. Install the new version of the plugin pack. See [Installing Offline Plugin Packs](#installing-offline-packs).