# Getting Started

## BrazenCloud

[BrazenCloud](https://brazencloud.io) is a Software-as-a-Service (SaaS) platform that allows you to deliver and run any predefined, arbitrary code on Windows and Linux endpoints. BrazenCloud allows you to operationalize any script, API call, freeware or open-source software at scale and perform ad hoc Actions anywhere in your hybrid cloud environment. Results created by Actions can be delivered from any BrazenAgent to any other BrazenAgent without any special networking considerations.

### Getting Started

If this is your first time using BrazenCloud, then welcome! Here is everything you need to get started:

* You first need an account, you can sign up for one on the login page: <https://portal.runway.host>

{% hint style="info" %}
**Please note:** The free Community Version is limited to 100 devices. If you are interested in a larger scale trial, please reach out: <info@brazencloud.io>.
{% endhint %}

* Familiarize yourself with the BrazenCloud terminology:
  * [BrazenAgent](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-brazenagent)
  * [Action](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-an-action)
  * [Job](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-job)
    * [Results](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-job/job-results)
    * [Output](https://docs.brazencloud.com/runway-documentation/action-developer-guides/troubleshooting#stdout)
  * [Service](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-service)
* [Install your first BrazenAgent](#installing-your-first-brazenagent)

Each entity (desktop, laptop, server, VM, container, etc) with an OS (Windows, Linux) can be a BrazenAgent if you [install the BrazenAgent](https://docs.brazencloud.com/runway-documentation/brazenagent-deployment/brazenagent-deployment) using the [BrazenCloud utility](https://docs.brazencloud.com/runway-documentation/brazencloud-utility/command-list). Once installed, you can [build a Job](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-job/define-job) to run any sort of code that is supported on the targeted BrazenAgents. This includes, but is not limited to [PowerShell](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-an-action/powershell/using-the-template), [Python](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-an-action/python/using-the-template), or [binary](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-an-action/binary/using-the-template) Actions. Then ultimately you can [send data to a Service](https://docs.brazencloud.com/runway-documentation/general-concepts/what-is-a-service/define-job-with-service).

BrazenCloud is also able to run [asset discovery](https://docs.brazencloud.com/runway-documentation/use-cases/basics) on any network with a BrazenAgent on it. After running an asset discovery, you can even leverage a single BrazenAgent to [automatically deploy BrazenCloud](https://docs.brazencloud.com/runway-documentation/brazenagent-deployment/bulk-deployment/automatic-deployment) to an entire network.

### Installing Your First BrazenAgent

When logging into the BrazenCloud portal for the first time, you will see the screen below that says, "You currently have no endpoints in this group":

![No endpoints](https://2343438631-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPTvK1CdnhFLKq9NvZswM%2Fuploads%2Fgit-blob-1e8b0b1a250e42abd39134b4944015098a103ad8%2Fno-endpoints.png?alt=media)

That means that we need to get some added! Click on the blue 'ADD ENDPOINTS' to get started (seen in the above screen shot). This opens the 'Add Endpoints' screen:

![Add endpoints Portal](https://2343438631-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPTvK1CdnhFLKq9NvZswM%2Fuploads%2Fgit-blob-e1957140fdc750f2f47faae15cd186328e11a7a7%2Fadd-endpoint-ui.png?alt=media)

If you haven't yet downloaded the BrazenCloud utility, you have the option to do so here by clicking on the green 'Download' button. This downloads the Windows version of the utility by default, to download other versions see the [BrazenCloud Utility Overview](https://docs.brazencloud.com/runway-documentation/brazencloud-utility/overview).

The [install command](https://docs.brazencloud.com/runway-documentation/brazencloud-utility/command-list#install) is listed under 'ENROLL USING A TOKEN'.

If you are ready to jump in and get your first BrazenAgent installed, simply run the command in an elevated console.

If you would like to see more detailed instructions, check out the deployment guide:

{% content-ref url="../brazenagent-deployment/manual-deployment" %}
[manual-deployment](https://docs.brazencloud.com/runway-documentation/brazenagent-deployment/manual-deployment)
{% endcontent-ref %}

## Developing for BrazenCloud

With BrazenCloud, you have 2 options to extend the platform:

* [Writing your own Actions](https://docs.brazencloud.com/runway-documentation/action-developer-guides/overview)
* [Developing against the API](https://docs.brazencloud.com/runway-documentation/api/overview)