Environment Setup Issues

Solutions to Kerno test environment setup issues.

The environment isn't starting

If Kerno is failing to start your application and it's dependencies, try the following troubleshooting steps:

• Make sure you project contains a valid Dockerfile at the root directory of your workspace, so Kerno can use it to start your application. If you don't have one, Kerno will create one for you that you will be able to see in .kerno/Dockerfile.

• Make sure your stack is supported by Kerno.

• Inspect the Docker Compose YAML file generate by Kerno, and if you see any wrong add guidance to the docker compose.md file to provide Kerno extra context as shown here.

Do not modify the generated docker compose YAML directly. Any manual edit will be overwritten by Kerno. All changes must go in the .kerno/docker-compose.md file so Kerno can apply them safely.

Running Docker without root

Docker must be usable without sudo. This is required for Kerno's agents that interact with Docker automatically.

Add your user to the Docker group, you will need to launch a new terminal to make it works:

sudo usermod -aG docker $USER
# Testing
docker run hello-world

If issues persists please drop us a message us on Slack, and we’ll gladly help.