Installing on Docker

Prerequisites

1. Create a Middleware account
2. Keep logging into your account  
3. If you are a Windows user, make sure Bash and curl tools are installed in your system. 

Use our one-step easy installation 

To proceed with the agent installation, make sure you have docker installed and running on your system. You can install docker for windows or macOS or Ubuntu.

To install an agent on a host, copy the  Installation command and paste it into the command prompt. Your command will look like the following example, and it will include your API key, so you won't need to create one.

MW_API_KEY=xxxxxxxxxxxxxxxxxxx TARGET=us1-v1-grpc.middleware.io:443 bash -c "$(curl -L https://host.middleware.io/scripts/docker-install.sh)"

If you are using a Windows system, you can configure the ENV variables as follows.

set MW_API_KEY=xxxxxxxxxxxxxxxxx && set TARGET=us1-v1-grpc.middleware.io:443 && bash -c "$(curl -L https://host.middleware.io/scripts/docker-install.sh)"

*If you are using the above command, replace the MW_API_KEY value with your API Key

Verify the status of agent 

Run the agent’s status command to verify the installation.

docker ps -a --filter ancestor=ghcr.io/middleware-labs/agent-host-go:dev

A successful installation returns the status UP or Exited and in case of unsuccessful installation, the status will be blank.
Sample of successful installation in docker

Samples of unsuccessful installation in docker

Uninstall the Middleware agent

To uninstall the middleware agent, please use the following command.

docker stop `docker ps -a -q --filter ancestor=ghcr.io/middleware-labs/agent-host-go:dev`

docker rm `docker ps -a -q --filter ancestor=ghcr.io/middleware-labs/agent-host-go:dev`