# RAIRlite (Single VM)

## Simple Deployment

Getting up and running with RAIRprotocol is easy! 

1. Pick where you'd like to deploy. [Windows WSL](https://docs.rairprotocol.org/rairprotocol/installation-and-testing/getting-started/rairlite-single-vm/windows-wsl-installation), Ubuntu Local, or Ubuntu Cloud VM
2. Install Docker and Docker Compose
3. Clone/Fork our repo and run a simple docker command to deploy the entire system!
4. Configure Docker with your admin NFT and your own API keys (Alchemy, etc)

## Video Workflow

{% embed url="<https://www.youtube.com/watch?v=MmH-JmWkhQo>" %}
Screen capture installation flow
{% endembed %}

## Install Docker-Compose

RAIR deploys each its services in a self-contained Docker image. If you are building RAIR from a desktop environment, you can install [Docker Desktop](https://docs.docker.com/compose/install/) which also adds the`Docker-Compose` command line utility to your system.&#x20;

If another setup is desired, you can [install Docker-compose manually](https://docs.docker.com/compose/install/linux/#install-the-plugin-manually).&#x20;

***

## Configure .env

<figure><img src="https://3641609714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5tYv0KixTaiEIz5F9uBB%2Fuploads%2FOq0nuVYMWG4unApCeQ55%2Fimage.png?alt=media&#x26;token=a6c321e8-94ae-4a68-8d64-7bc9268d82b4" alt="" width="283"><figcaption></figcaption></figure>

Inside the repository root is a file called `.env.sample.` This template contains a list of values that are to be consumed during the build process:

1. Create a new file in `/rair` called `.env`
2. Copy and paste the contents of `.env.sample` into `.env`
3. Refer to the [Backend Variables Library](https://docs.rairprotocol.org/rairprotocol/codebase/rairdapp/rairnode/backend-variables-library) for help populating .`env`.

***

## Build RAIRlite

It's the moment of truth. From the command line, in the repository root, run:

`docker-compose -f {dockerfile.yml} up`&#x20;

Wait for the build to complete. (*This may take a while if it's the first time as dependencies need to be downloaded*)

Once successfully deployed, point the browser to the RAIRfrontend service (probably localhost:8080, or wherever you set the host in `.env`).&#x20;

You should see the application running!

***

## Test plan

Finally, to ensure that you are running the Minimum Viable Product, execute our [MVP Test Plan](https://docs.rairprotocol.org/rairprotocol/installation-and-testing/getting-started/rairlite-single-vm/mvp-test-plan).