# Installing and Integrating an External Cypher Appliance

The external Cypher appliance runs on a small separate VM and supports a variety of base OS distributions. Credentials are securely passed to the external appliance and can be retrieved and consumed in specific places within HPE Morpheus Enterprise UI. The download URL for the installer can be retrieved from HPE Morpheus Enterprise [Hub](https://app.morpheushub.com/), replace the placeholder URL in the instructions below with the correct URL for the latest version of the Cypher appliance.

Begin by provisioning and updating the VM for the Cypher appliance. Then, download the installer. The following steps go through the installation process on Ubuntu but, as mentioned in the previous paragraph, many popular distributions are supported.

```
```
# An example URL is shown below, find the URL for the latest version and for the correct distro at |morpheus| Hub  
wget https://www.hpe.com/support/hpesc/path/to/morpheus-cypher_$version_amd64.deb
```
```

Next, install and reconfigure the package.

```
```
sudo dpkg -i morpheus-cypher_$version_amd64.deb  
sudo morpheus-cypher-ctl reconfigure
```
```

After the installation and reconfigure is complete, we need to record the generated API key so we can integrate the external Cypher store with HPE Morpheus Enterprise in a later step. We can get this from the logs with the following command:

```
```
sudo morpheus-cypher-ctl tail  
==> /var/log/morpheus-cypher/cypher/current <==  
2022-02-02_15:22:27.84848 |  \/  (_) ___ _ __ ___  _ __   __ _ _   _| |_  
2022-02-02_15:22:27.84848 | |\/| | |/ __| '__/ _ \| '_ \ / _` | | | | __|  
2022-02-02_15:22:27.84848 | |  | | | (__| | | (_) | | | | (_| | |_| | |_  
2022-02-02_15:22:27.84848 |_|  |_|_|\___|_|  \___/|_| |_|\__,_|\__,_|\__|  
2022-02-02_15:22:27.84849   Micronaut (v3.2.2)  
2022-02-02_15:22:27.84849  
2022-02-02_15:22:28.09130 15:22:28.087 [main] INFO  i.m.context.env.DefaultEnvironment - Established active environments: [ec2, cloud]  
2022-02-02_15:22:30.15129 15:22:30.151 [main] INFO  c.m.cypher.service.CypherService - Root Data: null  
2022-02-02_15:22:30.83499 15:22:30.834 [main] INFO  c.m.cypher.service.CypherService - Initialized Root Token: c90xxxx00000xxxxxx000000xxxxx000 ... Write this down as it will only display once  
2022-02-02_15:22:32.01282 15:22:32.012 [main] INFO  io.micronaut.runtime.Micronaut - Startup completed in 4749ms. Server Running: http://localhost:8080
```
```

IMPORTANT

The API key is only shown once when the appliance is first installed. Securely store this API key for later reference or you will be unable to integrate this Cypher appliance with any other HPE Morpheus Enterprise appliances.

This completes the installation process, move to HPE Morpheus Enterprise UI to integrate the remote Cypher store with HPE Morpheus Enterprise. Cypher integrations are added in Infrastructure > Trust > Integrations. Click + ADD and then click Cypher. Configure the following:

- **NAME:** A name for the Cypher integration in HPE Morpheus Enterprise
- **ENABLED:** When checked, this Cypher integration is available for storing and retriving credentials
- **API HOST:** The URL where your Cypher appliance can be reached (ex. <https://x.x.x.x/>)
- **API KEY:** The API Key we retrieved and saved in the previous step

![../../_images/addCypherInt.png](https://support.hpe.com/hpesc/public/api/document/sd00007732en_us/GUID-37B0DB77-147F-4EA0-BD49-CB4DA1253ED4-high.png)

Click SAVE CHANGES to save the new integration. Refer to the “Credentials” section above for details on storing new credential sets using the external appliance and how they can be called back in various places throughout the UI.
