# Getting started with Snowbridge
> Install and configure Snowbridge using Docker or binaries to start replicating event streams between sources and targets.
> Source: https://docs.snowplow.io/docs/api-reference/snowbridge/getting-started/
> Documentation index: https://docs.snowplow.io/llms.txt

The fastest way to get started and experiment with Snowbridge is to run it via the command line:

1. Download the pre-compiled ZIP from the [releases](https://github.com/snowplow/snowbridge/releases/)
2. Unzip and run the binary with eg. `echo "hello world" | ./snowbridge`

The defaults for the app are stdin source, no transformations, and stdout target - so this should print the message 'hello world' along with some logging data to the console.

Next, the app can be configured using HCL - simply create a configuration file, and provide the path to it using the `SNOWBRIDGE_CONFIG_FILE` environment variable.

You can find a guide to configuration in the [configuration section](/docs/api-reference/snowbridge/configuration/).

**Telemetry notice**

By default, Snowplow collects telemetry data for Snowbridge (since version 1.0.0). Telemetry allows us to understand how our applications are used and helps us build a better product for our users (including you!).

This data is anonymous and minimal, and since our code is open source, you can inspect [what’s collected](https://raw.githubusercontent.com/snowplow/iglu-central/master/schemas/com.snowplowanalytics.oss/oss_context/jsonschema/1-0-1).

If you wish to help us further, you can optionally provide your email (or just a UUID) in the `user_provided_id` configuration setting.

If you wish to disable telemetry, you can do so by setting `disable_telemetry` to `true`.

See our [telemetry principles](/docs/get-started/self-hosted/telemetry/) for more information.

## Distribution options

There are two distributions of Snowbridge.

**Default:**

The default distribution contains everything except for the [Kinesis source](/docs/api-reference/snowbridge/configuration/sources/kinesis/), i.e. the ability to read from AWS Kinesis. This distribution is all licensed under the [Snowplow Limited Use License Agreement](/limited-use-license-1.0/). _(If you are uncertain how it applies to your use case, check our answers to [frequently asked questions](/docs/licensing/limited-use-license-faq/).)_

It’s available on Docker:

```bash
docker pull snowplow/snowbridge:6.1.0
docker run snowplow/snowbridge:6.1.0
```

**AWS-specific (includes Kinesis source):**

The AWS-specific distribution contains everything, including the [Kinesis source](/docs/api-reference/snowbridge/configuration/sources/kinesis/), i.e. the ability to read from AWS Kinesis. Like the default distribution, it’s licensed under the [Snowplow Limited Use License Agreement](/limited-use-license-1.0/) ([frequently asked questions](/docs/licensing/limited-use-license-faq/)). However, this distribution has a dependency on [twitchscience/kinsumer](https://github.com/twitchscience/kinsumer), which is licensed by Twitch under the [Amazon Software License](https://github.com/twitchscience/kinsumer/blob/master/LICENSE).

To comply with the [Amazon Software License](https://github.com/twitchscience/kinsumer/blob/master/LICENSE), you may only use this distribution of Snowbridge _“with the web services, computing platforms or applications provided by Amazon.com, Inc. or its affiliates, including Amazon Web Services, Inc.”_

It’s available on Docker:

```bash
docker pull snowplow/snowbridge:6.1.0-aws-only
docker run snowplow/snowbridge:6.1.0-aws-only
```

***

## Deployment

The app can be deployed via services like EC2, ECS or Kubernetes using docker.

Configuration and authentication can be done by mounting the relevant files, and/or setting the relevant environment variables as per the standard authentication methods for cloud services.
