openconductor-install

@openconductor/install

Official OpenConductor installer package for seamless setup across all platforms.

Quick Install

NPM Method (Recommended)

# Latest stable release
npx openconductor-install

# With options
npx openconductor-install --enterprise --port 8080

Curl Method (Unix/Linux/macOS)

# Basic installation
curl -fsSL https://install.openconductor.ai | bash

# Enterprise installation
curl -fsSL https://install.openconductor.ai | bash -s -- --enterprise

# Custom directory and port
curl -fsSL https://install.openconductor.ai | bash -s -- --directory ./my-openconductor --port 8080

PowerShell Method (Windows)

# Coming soon - use NPM method for now
iwr https://install.openconductor.ai/install.ps1 | iex

Installation Options

Option	Description	Example
--enterprise	Enable enterprise features from start	npx openconductor-install --enterprise
--community-only	Install community edition only	npx openconductor-install --community-only
--directory <path>	Custom installation directory	npx openconductor-install --directory ./my-oc
--port <port>	Frontend port number	npx openconductor-install --port 8080
--team-size <size>	Expected team size (enterprise)	npx openconductor-install --enterprise --team-size 10
--sso	Enable SSO configuration	npx openconductor-install --enterprise --sso
--compliance	Enable compliance features	npx openconductor-install --enterprise --compliance
--silent	Silent installation with defaults	npx openconductor-install --silent
--dev	Development mode installation	npx openconductor-install --dev

System Requirements

Minimum Requirements

• Node.js: 18.0.0 or higher
• npm: 8.0.0 or higher
• Git: Any recent version
• Memory: 4GB RAM recommended
• Disk Space: 2GB free space
• Internet: Required for initial setup

Supported Platforms

• ✅ Windows 10/11 (x64, ARM64)
• ✅ macOS 10.15+ (x64, Apple Silicon)
• ✅ Linux (Ubuntu 18+, CentOS 7+, Debian 9+, Fedora 30+)

Required Ports

• Frontend: 5174 (configurable)
• Backend API: 3003
• Auth Server: 3006
• MCP Discovery: 3001
• Trinity AI Agents: 3007, 3008, 3009

Installation Types

🧑‍💻 Community Edition (Free)

Perfect for individual developers and small projects.

npx openconductor-install --community-only

Features:

• ✅ Full Trinity AI system (Oracle, Sentinel, Sage)
• ✅ Complete MCP server marketplace (2,340+ servers)
• ✅ Visual workflow builder
• ✅ Intelligent discovery and recommendations
• ✅ Community support

👥 Team Edition ($99/user/month)

Designed for small to medium development teams.

npx openconductor-install --enterprise --team-size 5

Additional Features:

• ✅ Multi-tenant team workspaces
• ✅ Real-time collaboration
• ✅ Team analytics and insights
• ✅ Shared project management
• ✅ Email support

🏢 Enterprise Edition (Custom pricing)

Full-featured enterprise platform with advanced security and compliance.

npx openconductor-install --enterprise --sso --compliance --team-size 50

Additional Features:

• ✅ Advanced RBAC (5-role system)
• ✅ SSO integration (Okta, Azure AD, Google)
• ✅ Audit trails and compliance reporting
• ✅ Custom branding and white-label options
• ✅ 24/7 dedicated support
• ✅ Professional services

Post-Installation

After installation completes:

• Access the Platform

  • Frontend: http://localhost:5174
  • Backend API: http://localhost:3003
  • Documentation: http://localhost:3003/api/docs

• First Steps

  • Complete the onboarding wizard
  • Install your first MCP servers
  • Create a workflow automation
  • Explore Trinity AI recommendations

• Enterprise Setup (if applicable)

  • Configure team workspaces
  • Set up user roles and permissions
  • Integrate with SSO provider
  • Enable compliance features

Management Commands

Check Status

npx openconductor-install status --directory ./openconductor

Upgrade Installation

npx openconductor-install upgrade --directory ./openconductor

Uninstall

npx openconductor-install uninstall --directory ./openconductor

Keep Data During Uninstall

npx openconductor-install uninstall --directory ./openconductor --keep-data

Troubleshooting

Common Issues

Port Conflicts

# Check what's using port 5174
lsof -i :5174  # macOS/Linux
netstat -ano | findstr :5174  # Windows

# Install with different port
npx @openconductor/install --port 8080

Permission Errors

# Fix npm permissions (macOS/Linux)
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# Or use different directory
npx @openconductor/install --directory ~/openconductor

Network Issues

# Configure npm proxy
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# Try different registry
npm config set registry https://registry.npmjs.org/

Getting Help

• 📚 Documentation: https://docs.openconductor.ai
• 💬 Community Discord: https://discord.gg/openconductor
• 🐛 Report Issues: https://github.com/OpenConductor-ai/openconductor/issues
• 📧 Enterprise Support: [e-mail]

Development

Building from Source

git clone https://github.com/OpenConductor-ai/openconductor.git
cd openconductor/packages/install
npm install
npm run build
npm link

Testing

npm test

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file for details.

Built with ❤️ by the OpenConductor Community

Website • Documentation • Community