Upgrading Your Kubos Development Environment

New updates will be announced to the Kubos community and the new releases will be published through GitHub. There will may instructions depending on the specific release details of all the steps needed to upgrade for the newest release.

Upgrading Kubos CLI

Inside of a Vagrant box lives the Kubos CLI. Upon new Kubos releases there may be updates for the Kubos CLI.

First SSH into your kubos-dev box:

$ cd <The path containing your kubos-dev Vagrantfile>
$ vagrant up
$ vagrant ssh

Then, upgrade the Kubos CLI:

$ kubos update --cli

New releases of the Kubos CLI may add or remove specific commands or command options. Tab completion is a feature that allows partially typed commands to be fully completed. Tab completion can also suggest possible arguments by pressing the <tab> key while typing a command. To keep tab completion synchronized with the Kubos CLI, run the following command:

$ kubos update --tab-completion

Upgrading the Kubos Source Modules

To update the Kubos source modules your project will be built with run the following command:

$ kubos update

To check which version of the CLI you’re using, use kubos version

To list all of the available versions of the Kubos source modules run:

$ kubos versions

To activate and use a new version of the Kubos source run:

$ kubos use <version number>

The use command will checkout and replace the existing Kubos source modules.

After running the use command, modules from the new version will be linked. If the new release holds new modules or has removed existing modules it may be necessary to re-link all modules to get rid of any module conflicts between new and old versions.

To relink all of the Kubos source modules simply run:

$ kubos link --all

Downgrading the Kubos Source Modules

In the event you want to downgrade to an older version of the Kubos source modules simply use the kubos use <version> command with the older version number you want to downgrade to.

Upgrading the Vagrant Box

Occasionally there will be an update or addition to one of the components of the Vagrant environment. When any of these components is changes we will package and release a new version of the kubos-dev box.

If there’s a new version of the box available you will see something similar to the following when you start the box:

$ vagrant up
==> default: A newer version of the box 'kubos/kubos-dev' is available! You currently
==> default: have version '0.2.2'. The latest is version '0.2.3'. Run
==> default: `vagrant box update` to update.

To manually check if your box is up-to-date you can run:

$ vagrant box outdated


Updating your box will overwrite the filesystem inside the environment.

Moving projects into synced folders prevents them from being overwritten since their actual location is external to the box. For more information on setting up synced folders see the Mounting a Host Directory section.

To update the box run:

$ vagrant box update
$ vagrant destroy
$ vagrant up


vagrant destroy must be used if you want your current box to be updated to use the new version.