***

title: Container Image Management (Advanced)
excerpt: >-
This document provides information on how to use the Moveworks Agent container
image directly, without the setup script.
deprecated: false
hidden: false
metadata:
robots: index
-------------

# Image Details

* **Image Name:** `moveworks/agent`
* **Version:** 2.10.3
* **Maintainer:** Moveworks
* **ECR Repository URL:** `public.ecr.aws/moveworks/agent:2.10.3`

# Features

* **Default Workdir:** The default working directory is set to `/home/moveworks/agent`.
* **Configuration Management:** Place your configuration YAML file, named `agent_config.yml` in `/home/moveworks/agent/conf`.
* **Certificate Handling:** Store required certificates in `/home/moveworks/agent/certs`. The agent creates an `agent_key.pem` certificate to encrypt `agent_config.yml`; write permissions are needed if this directory is being mounted.
* **Logging:** All log files are created in `/var/log/moveworks` and are also streamed to standard output.
* **Directory Permissions:** When mounting the above directories, ensure all files have read and write permissions for **user\_id 17540** and **group\_id 17540**.

# Requirements

* **Docker Version:** Ensure you have Docker version 20.10.0 or higher.
* **Host OS:** Compatible with Linux x86\_64 only.

# Usage

## Pulling the Image

```shell
docker pull public.ecr.aws/moveworks/agent:2.10.3
```

## Running the Container

```shell
docker run -d \
  -v /path/to/local/conf:/home/moveworks/agent/conf \
  -v /path/to/local/certs:/home/moveworks/agent/certs \
  -v /path/to/local/logs:/var/log/moveworks \
  -e LOG_LEVEL=INFO \
  public.ecr.aws/moveworks/agent:2.10.3
```

### Example

```shell
docker run -d \
  -v /myapp/conf:/home/moveworks/agent/conf \
  -v /myapp/certs:/home/moveworks/agent/certs \
  -v /myapp/logs:/var/log/moveworks \
  -e LOG_LEVEL=DEBUG \
  public.ecr.aws/moveworks/agent:2.10.3
```

# Container Configuration

* **Environment Variables:**
  * `LOG_LEVEL`: Sets the logging level. Options include `INFO`, `DEBUG`, `WARN`, `CRITICAL`, etc.
* **Volumes**:
  * `/home/moveworks/agent/conf`: Mount your configuration files here
  * `/home/moveworks/agent/certs`: Mount your certificates here.
  * `/var/log/moveworks`: Mount this directory to access log files.