Install Digi Embedded Yocto

If you already have a Digi Embedded Yocto version, go to Update Digi Embedded Yocto.

If you are working with a Docker image, you can skip this step. See Set up Digi Embedded Yocto Docker container on Linux or Set up Digi Embedded Yocto Docker container on Windows for more information on the Docker image for Digi Embedded Yocto.

If this is the first DEY-4.0 installation, follow these steps:

Install the repo tool.

To install Digi Embedded Yocto, you need the repo tool. Download repo to a directory within your path and add execution permissions.
```
$ sudo curl -o /usr/local/bin/repo http://commondatastorage.googleapis.com/git-repo-downloads/repo
$ sudo chmod a+x /usr/local/bin/repo
```
Create an installation folder.

The installation folder requires user write permissions. For example, create the directory /usr/local/dey-4.0, and navigate to that folder.
```
$ sudo install -o <your-user> -g <your-group> -d /usr/local/dey-4.0
$ cd /usr/local/dey-4.0
```
You can use the id command to get your primary user and group.

Use repo to download Digi Embedded Yocto. You have two installation options:

Install Digi Embedded Yocto from the kirkstone release branch (recommended). This allows you to keep up to date with Digi and the Yocto community fixes.
```
$ repo init -u https://github.com/digi-embedded/dey-manifest.git -b kirkstone
$ repo sync -j8 --no-repo-verify
```

Sync your installation with the release tag.

$ repo init -u https://github.com/digi-embedded/dey-manifest.git -b refs/tags/4.0-r7.2
$ repo sync -j8 --no-repo-verify

The release tag represents a snapshot from when the prebuilt Digi Embedded Yocto images were generated. Digi recommends you install from the kirkstone release branch so you continue to get updates from Digi and the Yocto community.

Update Digi Embedded Yocto

The Digi Embedded Yocto update process is different depending on your current Digi Embedded Yocto version.

Update an existing DEY-4.0 installation

To update a previous DEY-4.0 release, sync your installation with the HEAD of the release branch:

$ repo init -b kirkstone
$ repo sync -j8 --no-repo-verify

Update an existing installation older than DEY-4.0

If you are updating from a previous major release, you must install the new Digi Embedded Yocto release in a new directory. Follow the steps in Install Digi Embedded Yocto to download the new version.

You must recreate older projects for Digi Embedded Yocto 4.0.

Get update notifications

You can subscribe to the dey-manifest repository in github to be informed about Digi Embedded Yocto updates.

New Digi Embedded Yocto releases may include things like:

Software features
Bug fixes
Security fixes
Updates to machine layers and BSPs

Digi Embedded Yocto updates to a new Yocto Project release every year, updating all user space package versions.

Release notes

Digi Embedded Yocto release notes and changelog are bundled in the README included with the meta-digi layer.