v4.2.1 • Enterprise Edition

Environment Setup

Configure your local or cloud development workspace to interface with the Aevum Zenth Enterprise Platform. This guide covers SDK installation, CLI initialization, and environment provisioning.

System Requirements

ℹ️
Supported Platforms: Linux (Ubuntu 20.04+, Debian 11+), macOS 12+, Windows 10/11 (WSL2 recommended)
  • CPU: 4+ cores (8+ recommended for container orchestration)
  • RAM: 8GB minimum, 16GB+ recommended
  • Disk: 50GB available (SSD required for Docker volumes)
  • Runtime: Node.js 18+, Python 3.9+, Go 1.20+, or Rust 1.70+
  • Container Runtime: Docker 24+ or Podman 4+

Installation

Use the official Aevum Zenth package manager or your native OS package manager to install the CLI and core SDK.

macOS
Linux
Windows
bash 
# Install via Homebrew
brew tap aevum-zenth/core
brew install aevum-cli aevum-sdk
bash 
# Add repository & install
curl -sL https://apt.aevumzenth.dev/install.sh | sudo bash
sudo apt install aevum-cli aevum-sdk
powershell 
# Install via winget (Admin)
winget install AevumZenth.AevumCLI
winget install AevumZenth.AevumSDK
⚠️
Important: Windows users must run PowerShell as Administrator and ensure WSL2 is properly configured before proceeding.

Configuration

Initialize your workspace and generate the required configuration files. The CLI will automatically scaffold a `.aevum/` directory in your project root.

bash 
# Authenticate with your enterprise tenant
aevum auth login --tenant zenth-corp-dev

# Initialize local environment
aevum env init --profile local-dev

# Pull latest environment templates
aevum env pull --remote origin

Environment Variables

Create a `.env.local` file in your project root. The SDK will automatically load these variables during runtime.

env 
AEVUM_TENANT_ID=tz_dev_8a9f2c1e
AEVUM_API_KEY=ak_live_****************
AEVUM_ENV_PROFILE=sandbox
AEVUM_LOG_LEVEL=debug
AEVUM_DOCKER_REGISTRY=registry.aevumzenth.dev/dev

Verification

Run the following command to validate your installation and environment configuration:

$ aevum env verify
  ✔ CLI version 4.2.1 verified
  ✔ SDK components loaded (4/4)
  ✔ Docker daemon reachable
  ✔ Tenant authentication valid
  ✔ Local sandbox provisioned
Environment is ready. Run aevum up to start services.
✅
Ready to develop? Navigate to your project root and run aevum dev to launch the hot-reload development server.

Troubleshooting

1

Permission Denied on Docker

Ensure your user is in the docker group: sudo usermod -aG docker $USER. Log out and back in.

2

Tenant Authentication Failed

Clear cached tokens: aevum auth logout and re-run the login command with your updated API key.

3

Port Already in Use

Aevum Zenth default services run on 8000-8005. Override via: aevum config set base-port 9000

For advanced issues, check the internal diagnostic logs at ~/.aevum/logs/diag.log or submit a ticket via the Developer Support Portal.