For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
ReferenceGuides
ReferenceGuides
  • Agent Studio
    • Overview
    • Quickstart Guides
    • Core Concepts
    • Conversation Process
    • Actions
    • Connectors
    • System Triggers
    • Agent Architect
    • Cookbooks
    • Development and Testing
    • AI Agent Marketplace
    • Developer Tools
  • Agentic AI
    • LLM Fundamentals
    • The Agentic Reasoning Engine
    • Memory Constructs
    • Conversational Context
    • Guardrails
    • Grounding and Hallucinations
    • Continuous Learning
    • LLMs & SLMs
    • Steerability Tools
    • Multilingual Support
  • Core Platform
    • User Identity
    • Moveworks Agent (On-Prem)
      • On-Prem Agent Installation Guide
      • On-Prem Agent Quickstart
      • On-Prem Agent Configuration Guides
      • On-Prem Agent Operations and Health
      • On-Prem Agent Troubleshooting
      • On-Prem Agent Container Image Management
    • Approvals Engine
    • Entity Catalog
    • Moveworks Data Objects
    • Security Information and Event Management (SIEM) Logs Overview
DeveloperAcademyCommunityStatus
On this page
  • Image Details
  • Features
  • Requirements
  • Usage
  • Pulling the Image
  • Running the Container
  • Example
  • Container Configuration
Core PlatformMoveworks Agent (On-Prem)

On-Prem Agent Container Image Management

This document provides information on how to use the Moveworks Agent container image directly, without the setup script.
||View as Markdown|
Was this page helpful?
Edit this page
Previous

Approvals Engine

Next
Built with

This guide is for advanced deployments that manage the container image directly. Most installations should use the setup script instead — see the Installation Guide.

Image Details

  • Image Name: moveworks/agent
  • Version: See ECR gallery for the latest version tag
  • Maintainer: Moveworks
  • ECR Repository URL: public.ecr.aws/moveworks/agent:<version>

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

$docker pull public.ecr.aws/moveworks/agent:<version>

Running the Container

$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:<version>

Example

$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:<version>

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.