Installation

This guide provides step-by-step instructions for setting up Synapse on your local machine or in a cloud environment. Synapse can be deployed using Docker, Kubernetes, or directly on your system using the provided .NET binaries.

Installation Methods

Docker Compose

The Docker Compose method allows you to run all Synapse components as Docker containers.

Prerequisites:

• Docker: Ensure that Docker is installed on your system. You can download it from Docker's official website.

Steps:

1. Download the Docker Compose file:

   wget https://raw.githubusercontent.com/serverlessworkflow/synapse/main/deployments/docker-compose/docker-compose.yml

2. Start the Synapse services:

   docker-compose up

This will start the Synapse services as defined in the docker-compose.yml file. The API server and other components will be accessible according to the configuration in this file.

Development Installation with Docker Compose

For development purposes, if you wish to build the Docker images yourself, follow these steps:

Prerequisites:

• Docker: Ensure that Docker is installed on your system.
• Git: You need Git to clone the repository.

Steps:

1. Clone the Synapse Repository:

   git clone https://github.com/serverlessworkflow/synapse.git

2. Navigate to the Docker Compose directory:

   cd synapse/deployments/docker-compose

3. Build the Docker images:

   docker-compose -f docker-compose.build.yml build

4. Start the Synapse services:

   docker-compose -f docker-compose.build.yml up

Kubernetes

Deploying Synapse in a Kubernetes cluster provides a robust solution for production environments.

Prerequisites:

• Kubernetes: Ensure you have access to a Kubernetes cluster.

• Helm: Helm must be installed to manage Kubernetes applications. You can install Helm using the following command:

  curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Steps:

1. Add the Synapse Helm repository:

   helm repo add synapse https://serverlessworkflow.github.io/synapse/charts

2. Install Synapse using Helm:

   helm install synapse synapse/synapse

3. Verify the installation:

   kubectl get pods -n synapse

This will deploy Synapse components within your Kubernetes cluster. You can customize the installation using Helm values.

Running with .NET Binaries

Running Synapse directly with .NET binaries allows you to run the services without Docker or Kubernetes.

Prerequisites:

• .NET 8.0 SDK: Ensure the .NET 8.0 SDK is installed on your system. You can download it from Microsoft's official website.

Steps:

1. Download the latest release:

   Visit the Synapse releases page and download the appropriate binaries for your system.

2. Extract the binaries:

   tar -xzf synapse-<version>.tar.gz
   cd synapse-<version>

3. Run the Synapse API Server:

   dotnet Synapse.Api.Server.dll

4. Run other components as needed:

   You can start other components (e.g., Operator, Correlator) similarly by running their respective .dll files:

   dotnet Synapse.Operator.dll

Using the synctl CLI

The synctl CLI allows you to interact with the Synapse API from the command line.

Prerequisites:

• synctl CLI: Download the synctl binary from the Synapse releases page.

Steps:

1. Make the binary executable:

   chmod +x synctl

2. Set up the Synapse API server:

   synctl config set-api default -server=http://localhost:8080

You can now use synctl to create, manage, and run workflows.

Next Steps

• Quick Start Guide: Learn how to create and run your first workflow.
• API Documentation: Explore the API endpoints and how to use them.

Troubleshooting

If you encounter any issues during installation, check the troubleshooting guide or visit the discussions page for help from the community.