# 4.1 Quick start: Set-up a local development environment

{% hint style="warning" %}

### Important! Please read

The following instructions will guide you on how to set up a local, development environment of OpenCRVS, on your laptop, using our fictional country configuration: "Farajaland" for development and configuration purposes.  To learn how to deploy OpenCRVS to a server host, the documentation is at [3.3 Set-up a server-hosted environment.](/v1.7/setup/3.-installation/3.3-set-up-a-server-hosted-environment.md)
{% endhint %}

{% hint style="danger" %}
While you can run these commands on a Virtual Machine, you cannot convert the running software into a deployed server.  These scripts only run OpenCRVS dependencies in Docker and the rest of the node services run outside of containers.  To deploy an OpenCRVS server that you can access over a network, follow the documentation here: [3.3 Set-up a server-hosted environment.](/v1.7/setup/3.-installation/3.3-set-up-a-server-hosted-environment.md)
{% endhint %}

{% hint style="warning" %}
We recommend that you setup OpenCRVS on your local laptop to work with our fictional country repo before proceeding to fork and create your own country configuration.

In order to run OpenCRVS, we expect that you have a working knowledge of Linux / Unix operating systems and can run terminal commands.  You should also be familiar with Docker and NodeJS.
{% endhint %}

First, you will have to install some dependencies on your local computer.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.opencrvs.org/v1.7/setup/3.-installation/3.1-set-up-a-development-environment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
