Skip to main content

Troubleshoot your development environment with inctl doctor

If you're experiencing issues with your local development environment, then you can use the inctl doctor tool to try and diagnose your issue or collect information to help support diagnose your issue.

Use inctl doctor to check for common problems​

To check for common issues you can run the check verb:

$ inctl doctor check

Each check will either succeed, produce a warning, be skipped, or fail.

Checks that produce a warning may or may not be an issue but can usually be addressed so that the check passes either way.

A failing check indicates an issue that will probably prevent you from using your local development environment and needs to be addressed.

For both warnings and failed checks, additional details will be printed to the screen as part of the check.

Skipped checks will typically indicate what you need to do to enable them, for example providing additional information, for example with the --org or --solution flags.

Providing the --org flag​

Additional checks can be done by passing the --org flag as well, for example:

$ inctl doctor check --org intrinsic@intrinsic-prod-us

You can find out more about organizations and how to find yours on the connect to an organization page.

Providing the --solution flag​

If you have a flowstate session open, you can get your solution id from bug icon in the top-right part of the user interface.

Then you can pass it to inctl doctor like this:

$ inctl doctor check --org ORG --solution <solution id>

Note that if you use the --solution flag you must also provide the --org flag, as with other inctl commands.

Collect a report to help with support​

If you cannot resolve your issues yourself, you can also use inctl doctor to generate a report with details about your local development environment that may help when getting help:

$ inctl doctor check --org ORG --solution SOLUTION --report

This will produce a report as a JSON document, which can be easily copy-pasted into a support ticket or saved for use later. Make sure to review the information before sending it to anyone.