# Installation Guide

> Set up ReportingCloud without installing a server: create a trial account and an API key, add the .NET, PHP, Java or Ruby SDK and buy a subscription.

- **Product:** ReportingCloud
- **Section:** Documentation
- **Kind:** Topic
- **Path:** ReportingCloud > Installation Guide
- **1002 words**
- **Web URL:** https://docs.textcontrol.com/reporting-cloud/installation/
- **LLMs URL:** https://docs.textcontrol.com/reporting-cloud/installation/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/reporting-cloud/installation/llms-full.txt

---

ReportingCloud is a hosted service: the Web API, the document engine, the template storage and the ReportingCloud portal run on Text Control's servers on Microsoft Azure, and nothing is installed on a server of yours. Setting up means three things: a ReportingCloud account, an API key that your application sends with its requests and, if you want one, an SDK for .NET, PHP, Java or Ruby. The Installation Guide walks developers through them, and through the subscription an account needs before it goes into production.

To compare ReportingCloud with an installation on your own servers first, see how it differs from DS Server and TX Text Control .NET Server in the [Introduction](https://docs.textcontrol.com/reporting-cloud/overview/introduction/llms-full.txt).

### What You Set Up

| Step | Where | Needed |
|---|---|---|
| [An account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt) | The registration page of the portal, `https://portal.reporting.cloud/Account/Register/` | Always. It starts as a 30-day trial. |
| [An API key](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt) | **Manage Account** in the portal, or the endpoint `PUT /v1/account/apikey` | For every application that calls the Web API. The Java and Ruby SDKs use the user name (the email address you signed up with) and password of the account instead. |
| [An SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/llms-full.txt) | nuget.org, Packagist, RubyGems or the source code on GitHub | Optional. Any HTTP client can call the Web API. |
| [A subscription](https://docs.textcontrol.com/reporting-cloud/installation/subscription/llms-full.txt) | The Text Control online store, then **Manage Account** in the portal | Before business or commercial use, which the trial and the Free account don't allow |

### Where to Start

1. **Check the requirements** of your client: HTTPS, JSON and, if you use one, the runtime of the SDK, such as the .NET target framework or the PHP version. See [Requirements](https://docs.textcontrol.com/reporting-cloud/installation/requirements/llms-full.txt).
2. **Sign up for the trial** in the portal and verify your email address. The template storage of the new account holds the demo template `sample_invoice.tx`. See [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt).
3. **Create an API key** on the **Manage Account** page and keep it in the configuration of your application, for example in the environment variable `REPORTINGCLOUD_API_KEY`. See [API Keys](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt).
4. **Install an SDK** for your language, or skip this step and call the Web API with curl or your own HTTP client. See [Installing an SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/llms-full.txt).
5. **Create your first document** with one of the tutorials in [Getting Started](https://docs.textcontrol.com/reporting-cloud/getting-started/llms-full.txt).
6. **Add a subscription** before your application goes into production. See [Upgrading to a Subscription](https://docs.textcontrol.com/reporting-cloud/installation/subscription/llms-full.txt).

### Find the Right Page

| If you want to | Read |
|---|---|
| Check what a client and each SDK need: HTTPS, .NET target frameworks, PHP, Java and Ruby versions | [Requirements](https://docs.textcontrol.com/reporting-cloud/installation/requirements/llms-full.txt) |
| Sign up, verify your email address and log in to the portal | [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt) |
| Find out what the trial includes and what happens after 30 days | [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/#after-30-days) |
| Create, delete and list API keys in the portal or with the Web API | [API Keys](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt) |
| Add the NuGet package, the Composer package, the Java library or the Ruby gem to a project | [Installing an SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/llms-full.txt) |
| Deal with the `NU1903` warnings of the .NET package | [Installing an SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/#net) |
| Buy a subscription and add its serial number to your account | [Upgrading to a Subscription](https://docs.textcontrol.com/reporting-cloud/installation/subscription/llms-full.txt) |
| Compare the plans and their quotas | [Plans and Licensing](https://docs.textcontrol.com/reporting-cloud/overview/licensing/llms-full.txt) |

### Pages in This Section

- [Requirements](https://docs.textcontrol.com/reporting-cloud/installation/requirements/llms-full.txt): what every client needs, and the runtime and authentication of each SDK.
- [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt): the sign-up, the email verification, the first login and the trial.
- [API Keys](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt): create, use, delete and manage keys, and keep them secret.
- [Installing an SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/llms-full.txt): install the .NET, PHP, Java and Ruby SDKs and check the installation.
- [Upgrading to a Subscription](https://docs.textcontrol.com/reporting-cloud/installation/subscription/llms-full.txt): buy a subscription, find the serial number and add it in the portal.

---

## In This Section

- [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt): Sign up for the 30-day ReportingCloud trial in the portal: registration fields, password rules, email verification, first login and the demo template.
- [API Keys](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt): Create and delete API keys on Manage Account or with the account/apikey endpoints, send them in the Authorization header and keep them out of source code.
- [Requirements](https://docs.textcontrol.com/reporting-cloud/installation/requirements/llms-full.txt): Check what a ReportingCloud client needs: an account, HTTPS and JSON, plus the .NET target frameworks, PHP versions, Java build and Ruby gem of each SDK.
- [Installing an SDK](https://docs.textcontrol.com/reporting-cloud/installation/sdks/llms-full.txt): Install TXTextControl.ReportingCloud from NuGet, the PHP SDK with Composer, the Java library from source or the Ruby gem, and check it with a first call.
- [Upgrading to a Subscription](https://docs.textcontrol.com/reporting-cloud/installation/subscription/llms-full.txt): Move a trial or Free account to a paid plan: buy a monthly or yearly subscription in the Text Control store and add its serial number with Add Subscription.

---

## Nearby

- **Previous:** [Data Security and Privacy](https://docs.textcontrol.com/reporting-cloud/overview/security/llms-full.txt)
- **Next:** [Requirements](https://docs.textcontrol.com/reporting-cloud/installation/requirements/llms-full.txt)
