Skip to content

Table of contents

running a konnector locally

Locally but linked to a Cozy

This method requires a working cozy-stack. It will allow you to run the konnector outside the cozy-stack but saves the data inside the cozy-stack. This can be useful when your konnector is not available in one of the registries but you still want to save you data in your real Cozy.

You can find a detailed explanation inside the linking your konnector to a cozy page.

Installed from a local directory

This method requires a working cozy-stack with the admin permissions and the cozy-stack CLI. It will allow you to install your konnector exactly like it was published in a registry. This can be a good way to check locally if everything works well before publishing to the registry.

Installing the konnector

First build it:

yarn build

Start your cozy-stack server with the --dev flag. If you have the cozy-stack source code locally you can run this following command for example:

go run . serve --dev --config ~/.config/cozy/config.yaml --mailhog --fs-url=file://localhost${PWD}/storage --konnectors-cmd ${PWD}/scripts/konnector-dev-run.sh

You will need to have a valid configuration file.

Then you just have to run:

cozy-stack konnectors install <slug> files://<konnector folder absolute path>/build

Be careful to point the /build folder inside your konnector folder!

Run the konnector

Once connected to your Cozy instance (probably http://cozy.localhost:8080) you should have a new icon with your konnector name. Once you click on it, you will be asked the informations required to run the konnector. Once saved, the konnector will start running.

After modifying the konnector, clicking on the Synchronize button will fetch the new code an run it with the changes.