# Setup

1. Run the installation script:

```sh
curl -fsS https://install.empirica.dev | sh
```

That's it, you're done! Proceed to create your experiment:

{% content-ref url="/pages/-M-DU6peo0\_R4jW1X\_mJ" %}
[Creating your experiment](/getting-started/quick-start.md)
{% endcontent-ref %}

{% hint style="info" %}

#### Running an older version?

If you are running on an older version and are encountering version issues, try running the curl command above again. It should reset your local install.
{% endhint %}

{% hint style="success" %}

#### Upgrading

To upgrade the empirica command globally on your machine, you can either run `empirica upgrade --global` outside of any projects, or run the curl command above again.
{% endhint %}

{% hint style="warning" %}

#### Volta error

Some users have been seeing a Volta error that prevents empirica from properly managing node (here: <https://github.com/volta-cli/volta/issues/1744>). It can be resolved it by installing the right versions of node manually and removing the `volta` lines from `client/package.json` and `server/package.json`.
{% endhint %}

### **A note about Windows Setup**

{% hint style="warning" %}
Windows is currently not natively supported. Empirica does work on Windows with Microsoft's WSL 2.
{% endhint %}

{% hint style="danger" %}
The installation of WSL 2 has been greatly simplified since Windows 10 version 2004, released at the end of 2021. Windows 11 also benefits from the new much simplified procedure. The following documentation does not cover the new installation. If you are using Windows 10 2004 and higher, we recommend you look online how to install WSL 2, then you can follow the macOS/Linux procedure above.
{% endhint %}

Empirica is built on industry-standard open-source web technologies which run best in Unix-like operating systems such as Linux and macOS. \*\*\*\*

*If you are a Windows user and get stuck at any point in the development process, please contact <joshua.becker@ucl.ac.uk> or join the* [*Slack channel*](https://join.slack.com/t/empirica-ly/shared_invite/zt-1fb34yq47-YlgYUJmXJAdv7QmHsa_fdw) *for community-based technical support on a wide range of topics.*

{% content-ref url="/pages/-MQFm\_OhGD0ymKg\_sz4z" %}
[Windows WSL Instructions](/getting-started/setup/windows-instructions.md)
{% endcontent-ref %}


---

# 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://docs.empirica.ly/getting-started/setup.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.