Installing Modules

Modules provide the components you use in your flows. This guide covers how to find, install, and manage modules.

Module Catalog

Browsing Modules

Access the module catalog from:

1. Workspace Dashboard > Modules
2. Or during flow editing > Node Palette > Get More Modules

+-------------------------------------------------------------------+
| Module Catalog                                      [Search...]   |
+-------------------------------------------------------------------+
| Official Modules                                                  |
| +-- common-module    General purpose components       [Install]   |
| +-- http-module      HTTP server and client          [Installed]  |
| +-- database-module  Database connectors              [Install]   |
|                                                                   |
| Community Modules                                                 |
| +-- slack-module     Slack integration                [Install]   |
| +-- aws-module       AWS service connectors           [Install]   |
+-------------------------------------------------------------------+

Module Information

Click a module to see details:

• Description: What the module does
• Components: List of included components
• Version: Available versions
• Requirements: Resource requirements
• Documentation: Usage guide

Installing a Module

From Catalog

1. Find the module in the catalog
2. Click Install
3. Configure options:

+-------------------------------------------------------------------+
| Install: common-module                                            |
+-------------------------------------------------------------------+
| Version: [v1.5.0 v]                                               |
|                                                                   |
| Target Cluster: [production-gke v]                                |
|                                                                   |
| Configuration                                                     |
| +-- Replicas: [2]                                                 |
| +-- CPU Request: [100m]                                           |
| +-- Memory Request: [128Mi]                                       |
| +-- Enable Metrics: [x]                                           |
|                                                                   |
|                                       [Cancel] [Install]          |
+-------------------------------------------------------------------+

4. Click Install
5. Wait for deployment to complete

Installation Status

Monitor installation progress:

Installing common-module v1.5.0 to production-gke

[▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░] 80%

✅ Created namespace resources
✅ Applied RBAC permissions
✅ Deployed module pods
⏳ Waiting for pods to be ready...

[View Logs] [Cancel]

Via Helm (Advanced)

Install directly using Helm:

# Add TinySystems Helm repo
helm repo add tinysystems https://charts.tinysystems.io
helm repo update

# Install module
helm install common-module-v1 tinysystems/common-module \
  --namespace tinysystems \
  --set replicaCount=2 \
  --set image.tag=v1.5.0

Version Management

Available Versions

Modules support multiple versions:

Version	Status	Notes
v1.5.0	Latest	Current stable
v1.4.2	Stable	Previous stable
v1.4.1	Stable	Bug fixes
v1.3.0	Deprecated	Security update available

Updating Modules

1. Go to Modules > Installed module
2. Click Update
3. Select target version
4. Review changes
5. Click Update

+-------------------------------------------------------------------+
| Update common-module                                              |
+-------------------------------------------------------------------+
| Current Version: v1.4.2                                           |
| Target Version: [v1.5.0 v]                                        |
|                                                                   |
| Changes in v1.5.0:                                                |
| - Added new Router conditions                                     |
| - Improved Modify performance                                     |
| - Fixed memory leak in Split component                            |
|                                                                   |
| WARNING: Breaking Changes: None                                   |
|                                                                   |
|                                       [Cancel] [Update]           |
+-------------------------------------------------------------------+

Rollback

If an update causes issues:

1. Go to module settings
2. Click Rollback
3. Select previous version
4. Confirm rollback

Multi-Cluster Installation

Install to Multiple Clusters

Deploy the same module across clusters:

1. Select module
2. Click Install to Clusters
3. Select target clusters
4. Configure per-cluster settings (optional)
5. Click Install All

Consistent Versions

Ensure version consistency:

# Module versions across clusters
Cluster           Module          Version
-----------------------------------------
production-gke    common-module   v1.5.0
staging-eks       common-module   v1.5.0
dev-local         common-module   v1.5.0

Uninstalling Modules

Before Uninstalling

Check for dependencies:

1. Review flows using this module
2. Identify affected TinyNodes
3. Plan migration or removal

Uninstall Process

1. Go to Modules > Installed module
2. Click Uninstall
3. Review impact:

+-------------------------------------------------------------------+
| Uninstall common-module                                           |
+-------------------------------------------------------------------+
| WARNING: This will affect the following:                          |
|                                                                   |
| Flows (3):                                                        |
| - Order Processing - 5 nodes using this module                    |
| - Data Sync - 2 nodes using this module                           |
| - Notifications - 1 node using this module                        |
|                                                                   |
| These nodes will stop working after uninstall.                    |
|                                                                   |
|                              [Cancel] [Uninstall Anyway]          |
+-------------------------------------------------------------------+

4. Confirm uninstallation

Cleanup

After uninstalling:

• TinyNodes using the module become orphaned
• Remove or reconfigure affected flows
• Update any dependencies

Private Modules

Installing Custom Modules

For private/custom modules:

1. Go to Modules > Add Custom
2. Enter module details:

+-------------------------------------------------------------------+
| Add Custom Module                                                 |
+-------------------------------------------------------------------+
| Name: my-custom-module                                            |
|                                                                   |
| Image: ghcr.io/myorg/my-module:v1.0.0                             |
|                                                                   |
| Registry Credentials (optional):                                  |
| +-- Registry: ghcr.io                                             |
| +-- Username: myuser                                              |
| +-- Password: ********                                            |
|                                                                   |
|                                         [Cancel] [Add]            |
+-------------------------------------------------------------------+

Registry Authentication

For private registries:

# Create pull secret in cluster
kubectl create secret docker-registry my-registry-cred \
  --docker-server=ghcr.io \
  --docker-username=myuser \
  --docker-password=mytoken \
  -n tinysystems

Then reference in module configuration.

Troubleshooting Installation

Installation Stuck

If installation hangs:

1. Check cluster connectivity
2. Verify RBAC permissions
3. Check resource availability
4. Review pod events

kubectl get events -n tinysystems --sort-by='.lastTimestamp'
kubectl get pods -n tinysystems

Image Pull Errors

If pods can't pull images:

1. Verify image exists
2. Check registry credentials
3. Confirm network access

kubectl describe pod <pod-name> -n tinysystems | grep -A 5 "Events"

Version Conflicts

If version requirements conflict:

1. Check component dependencies
2. Update to compatible versions
3. Review release notes

Next Steps

• Available Modules - Explore modules
• Module Configuration - Configure modules
• Creating Your First Flow - Use modules