Loading image...Kiro
  • CLI
  • Powers
  • Autonomous agent
  • Enterprise
  • Pricing
  • Docs
SIGN INDOWNLOADS
Loading image...Kiro
Loading image...Kiro
Product
  • About Kiro
  • CLI
  • Powers
  • Autonomous agent
  • Pricing
  • Downloads
For
  • Enterprise
  • Startups
Resources
  • Documentation
  • Blog
  • Changelog
  • FAQs
  • Report a bug
  • Suggest an idea
  • Billing support
Social
Site TermsLicenseResponsible AI PolicyLegalPrivacy PolicyCookie Preferences
  1. Docs
  2. Autonomous agent
  3. Sandbox
  4. Environment Configuration

Environment Configuration

On this page
  • Automatic configuration
  • Dockerfile configuration

You can configure the sandbox environment using a Dockerfile. This defines your development environment configuration, including dependencies, build commands, and runtime requirements.

Automatic configuration

Kiro autonomous agent looks for a Dockerfile in the root of your repository. If found, the agent automatically configures the sandbox based on these specifications, ensuring the environment matches your project's requirements.

Only publicly available container images are supported. Private registry images and private repositories cannot be accessed by the sandbox.

Dockerfile configuration

You can use a standard Dockerfile to configure the sandbox environment. The agent will build and use the Docker image defined in your Dockerfile.

Example Dockerfile:

dockerfile
FROM node:18 WORKDIR /app # Install dependencies COPY package*.json ./ RUN npm install # Copy application code COPY . . # Set environment variables ENV NODE_ENV=production # Expose port EXPOSE 3000 # Start command CMD ["npm", "start"]
Page updated: December 12, 2025
MCP
GitHub