@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:

1. Access the Platform

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

2. First Steps

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

3. 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: [email protected]

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