# Getting Started with Zymkey USB

**URL:** <https://community.zymbit.com/t/getting-started-with-zymkey-usb/97>\
**Category:** ZYMKEY4\
**Created:** [December 21, 2016, 7:58pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97 "2016-12-21T19:58:53Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Phil\_S\_Zymbit\_1](https://avatars.discourse-cdn.com/v4/letter/p/45deac/32.png) [@Phil\_S\_Zymbit\_1](https://community.zymbit.com/u/Phil_S_Zymbit_1)\
**Post date:** [December 21, 2016, 7:58pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/1 "2016-12-21T19:58:53Z")

</div>

## Zymkey USB

![](https://yyz1.discourse-cdn.com/flex027/images/transparent.png)  
##Package Installation  
For a bare raspbian system, first:

`ssh pi@raspberrypi.local`

_Note:_ Your Zymkey will require a number of packages to be installed from the Raspberry Pi and Zymbit apt repositories. The following setup script will be installing a number of files and software packages on your system:

- Docker and docker-compose
- Zymbit .service files located in the `/etc/systemd/system` directory
- pip

Download and install the necessary Zymbit Cloud services  
`curl -G https://s3.amazonaws.com/zymbit-apt/setup.sh | sudo bash`  
(grab a cup of coffee because this will take some time ☕)

###Install Zymkey USB Hardware  
Zymkey will work in any of the four USB slots on your Pi  
 ![](https://yyz1.discourse-cdn.com/flex027/images/transparent.png) ![](https://yyz1.discourse-cdn.com/flex027/images/transparent.png)

##Bind Zymkey to Host  
Insure your Zymkey is plugged into the host Pi.

1. Visit [https://console.zymbit.com/](https://console.zymbit.com/)

2. Sign up and create a new project

3. Copy the bootstrap key as shown: ![](https://yyz1.discourse-cdn.com/flex027/images/transparent.png)

4. Return to the shell and paste in your bootstrap key in the following configuration file:  
`sudo nano /etc/systemd/system/zymbit-connect.service.d/10-env.conf`  
The configuration file should look similar to this when you are finished with step 4.

###Final Step  
Reload [https://console.zymbit.com](https://console.zymbit.com) and you should see your device with a Zymkey status of unbound and the option to Bind now! _Note:_ this could be delayed about a minute. Right now your pi is starting up the Zymbit connect service for the first time.

Click the Bind Now! Button and the Zymkey LED should turn a solid green. Your Zymkey is now bound!

##Moving Forward  
Please read the Zymkey community pages for documentation on:  
- [LUKS filesystem encryption](https://community.zymbit.com/t/zymkey-how-to-create-a-encrypted-disk-volume-using-zymkey/83)

- [Encrypting & decrypting sensor data on disk](https://community.zymbit.com/t/zymkey-encrypting-decrypting-sensor-data-on-disk/94)
  - [Real Time Clock](https://community.zymbit.com/t/zymkey-rtc-real-time-clock-support/84)

The quickest way to get started is to see the various methods at work by running these scripts:

`python /usr/local/share/zymkey/examples/zk_app_utils_test.py`  
`python /usr/local/share/zymkey/examples/zk_crypto_test.py`

---

<div class="post-metadata">

**Author:** ![Phil\_S\_Zymbit\_1](https://avatars.discourse-cdn.com/v4/letter/p/45deac/32.png) [@Phil\_S\_Zymbit\_1](https://community.zymbit.com/u/Phil_S_Zymbit_1)\
**Post date:** [December 21, 2016, 7:59pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/2 "2016-12-21T19:59:39Z")

</div>



---

<div class="post-metadata">

**Author:** ![Phil\_S\_Zymbit\_1](https://avatars.discourse-cdn.com/v4/letter/p/45deac/32.png) [@Phil\_S\_Zymbit\_1](https://community.zymbit.com/u/Phil_S_Zymbit_1)\
**Post date:** [December 22, 2016, 12:11am UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/3 "2016-12-22T00:11:27Z")

</div>



---

<div class="post-metadata">

**Author:** ![razron](https://avatars.discourse-cdn.com/v4/letter/r/5f8ce5/32.png) [@razron](https://community.zymbit.com/u/razron)\
**Post date:** [December 23, 2016, 4:32pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/4 "2016-12-23T16:32:38Z")

</div>

Is it possible to get this working on a non-raspberry pi hardware?

It appears most of the packages are available or the source package is available except for:  
libzk  
libzymkeyssl  
rtc-zymkey  
zkifc  
docker-hypriot

---

<div class="post-metadata">

**Author:** ![roberto](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.zymbit.com/roberto/32/4_2.png) [@roberto](https://community.zymbit.com/u/roberto)\
**Post date:** [December 23, 2016, 5:08pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/5 "2016-12-23T17:08:00Z")

</div>

Hey @razron, welcome!

It may be possible, especially the USB version, which does not depend on a GPIO pin layout.

While we are currently focused on nailing the Raspberry Pi experience internally, I’m personally interested and excited to see this working on other hardware as well! 🙂 Let me know if you’re going to give this a shot and I’ll help you out where I can. I would suggest sticking with an ARM-based Debian-like distro to start, as it will be easier. From there, first step would be to get the pre-requisites installed; the biggest one being Docker.

Give `setup.sh` a look and see if it “just works” on your device. Please report back with any issues you may have and we’ll go from there.

```auto
curl -s https://s3.amazonaws.com/zymbit-apt/setup.sh > zymbit-setup.sh
less zymbit-setup.sh

```

---

<div class="post-metadata">

**Author:** ![roens](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.zymbit.com/roens/32/54_2.png) [@roens](https://community.zymbit.com/u/roens)\
**Post date:** [September 5, 2017, 10:28pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/6 "2017-09-05T22:28:21Z")

</div>

Being a backer of your initial Kickstarter campaign, I’ve got a Zymkey. I’m finally getting around to setting it up for a project. I’ve attempted to run your `apt` [`setup.sh`](https://s3.amazonaws.com/zymbit-apt/setup.sh) script mentioned above. However, it seems the GPG `apt` key it attempts to load appears to be invalid, leading to errors in `apt-get`. Has the script and/or key been updated? How to proceed?

```auto
W: GPG error: https://zymbit-apt.s3.amazonaws.com stable Release: The following signatures were invalid: BADSIG CABC9FCA2954FDFE Zymbit Inc. <code@zymbit.com>

```

* * *

Oh, now I see this post: [https://community.zymbit.com/t/zymkey-apt-repo-url-has-changed/191/6](https://community.zymbit.com/t/zymkey-apt-repo-url-has-changed/191/6)

I’ve updated the URL in `/etc/apt/sources.list.d/zymbit.list`. But that `apt` GPG key is still invalid:

```auto
W: GPG error: https://zymkey-sw-repo.s3.amazonaws.com jessie InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 1E8314B357AE01DB

```

Probably your `setup.sh` script should be updated on S3…

* * *

➡ Solution discovered? … disregard the (legacy?) script mentioned on this page. And install download & run the setup script mentioned on [https://community.zymbit.com/t/getting-started-with-zymkey-4i/202](https://community.zymbit.com/t/getting-started-with-zymkey-4i/202) (and other more recent “Getting Started” pages here).

---

<div class="post-metadata">

**Author:** ![Phil\_S\_Zymbit\_1](https://avatars.discourse-cdn.com/v4/letter/p/45deac/32.png) [@Phil\_S\_Zymbit\_1](https://community.zymbit.com/u/Phil_S_Zymbit_1)\
**Post date:** [September 7, 2017, 4:57pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/7 "2017-09-07T16:57:39Z")

</div>

Hi Roens,

Thanks for backing us on Kickstarter ! That product is somewhat vintage and their may be some incompatibilties with our current products.

To help us help you, can you please send us the serial number (white label on early USB units). If you prefer to do this in a private channel, then do so here. [Contact Zymbit](https://zymbit.activehosted.com/f/5).

Thanks

---

<div class="post-metadata">

**Author:** ![eduardolopez](https://avatars.discourse-cdn.com/v4/letter/e/49beb7/32.png) [@eduardolopez](https://community.zymbit.com/u/eduardolopez)\
**Post date:** [November 9, 2018, 3:38pm UTC](https://community.zymbit.com/t/getting-started-with-zymkey-usb/97/8 "2018-11-09T15:38:15Z")

</div>

where can i purchase a usb zymkey?
