Any OS via Docker
Installing on any OS via Docker

Prerequisites

  1. Create a Middleware account
  2. Keep logging into your account
  3. If you are a Windows user, please 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.

Shell
MW_API_KEY=xxxxxxxxxxxxxxxxx TARGET=https://uid.middleware.io:443 bash -c "$(curl -L https://install.middleware.io/scripts/docker-install.sh)"

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

Shell
MW_API_KEY=xxxxxxxxxxxx TARGET=https://uid.middleware.io:443 bash -c "$(curl -L https://install.middleware.io/scripts/docker-install.sh)"
Replace the MW_API_KEY value with your API key or directly copy the full command with the API key from the installation menu.
Replace “uid” with the text in the URL (ex URL is “s05zpimz.middleware.io” , here s05zpimz is uid.)

Verify the status of agent

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

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

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.

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