Documentation

@zenlayer/n8n-nodes-sandbox

This is an n8n community node package that provides Zenlayer Sandbox integration for n8n workflows.

Zenlayer Sandbox is a secure, isolated code execution environment that allows you to run Python code, execute shell commands, and manage files in a sandboxed environment.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This package provides the following nodes:

  • Zenlayer Code Interpreter - Execute Python code in an isolated sandbox environment
  • Zenlayer Run Command - Execute shell commands in the sandbox
  • Zenlayer Upload File - Upload files to the sandbox filesystem
  • Zenlayer Download File - Download files from the sandbox filesystem

Credentials

To use these nodes, you need to set up Zenlayer Sandbox API credentials:

  1. Sign up for a Zenlayer Sandbox account at https://www.sandbox.zenlayer.ai/
  2. Get your API key from the dashboard
  3. In n8n, create a new credential of type "Zenlayer Sandbox API"
  4. Enter your API key
  5. Optionally specify a custom domain (defaults to sandbox.zenlayer.ai)

Compatibility

  • Minimum n8n version: 1.0.0
  • Tested with n8n versions: 1.0.0+

Usage

Code Interpreter Node

Execute Python code in a sandboxed environment. The node supports:

  • Batch processing of multiple input items
  • Connecting to existing sandboxes or creating new ones
  • Configurable timeout
  • Keep-alive mechanism to extend sandbox lifetime
  • Optional auto-recycle to kill sandbox after execution

Run Command Node

Execute shell commands in the sandbox. Returns exit code, stdout, and stderr.

Upload File Node

Upload binary files to the sandbox filesystem. Requires:

  • Binary data from previous nodes (e.g., HTTP Request, Read Binary File)
  • Target file path in the sandbox

Download File Node

Download files from the sandbox filesystem. Returns the file as binary data.

Resources

Version history

See CHANGELOG.md for detailed version history.

Discussion