> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing packages

> How to install Neuron packages using the command line or admin interface

Packages can be installed in two ways:

* With the Neuron admin page
* With the [`Waher.Utility.Install`](https://github.com/PeterWaher/IoTGateway/tree/master/Utilities/Waher.Utility.Install) command line tool

## Using Waher.Utility.Install

Make sure the Neuron is **not running** before installing. Then run `Waher.Utility.Install.exe` with:

* `-d "C:\ProgramData\IoT Gateway"` — path to the data folder
* `-s "C:\Program Files (x86)\Waher Data AB\IoT Gateway 1.0\Waher.IoTGateway.Svc.exe"` — path to the server executable
* `-p "C:\ProgramData\IoT Gateway\packages\PACKAGE_NAME.package"` — path to the package
* `-k AES_KEY`

Use the `-v` flag for verbose output.

To **update** a package, replace the `.package` file with the new one and install it the same way.

## Using the Neuron admin interface

First create an **installation key** by concatenating the public key and the AES key:

> If the public key is `WkpTPn8uK++vcjHXOQQ+MD/CAuCqfSufNAwnXdJdtO2Vx3u2yr1YNXV/MH83jlZcWJ2bu5kG19qA` and the AES key is `0e356c087f6a037ca9e7c4cf0702fed8`, the installation key is `WkpTPn8uK++vcjHXOQQ+MD/CAuCqfSufNAwnXdJdtO2Vx3u2yr1YNXV/MH83jlZcWJ2bu5kG19qA0e356c087f6a037ca9e7c4cf0702fed8`.

Then:

1. Navigate to `neuron.domain/UploadPackage.md`
2. Either download from the **Available software packages** list, or upload a `.package` file together with its `.signature` file
3. Uploading a package distributes it to all child Neurons

For a new version of an existing package, upload it the same way as a new one.

## Updating packages using the Neuron admin interface

1. Upload the new package version at `neuron.domain/UploadPackage.md`
2. Navigate to the **Chat Admin** page at `neuron.domain/ChatAdmin.md`
3. Type:

```text theme={null}
upgrade PACKAGE_NAME.package
```

To skip a backup during install:

```text theme={null}
upgrade nobackup PACKAGE_NAME.package
```

The Neuron will restart and the package will be updated.