📖
Empirica v1 Docs
  • Introduction
  • Getting Started
    • Setup
      • Windows WSL Instructions
    • Creating your experiment
    • Running your experiment
    • Updating your experiment
  • Guides
    • Tutorial: Your First Experiment
      • Part 1: Getting Started
      • Part 2: Configuring the Experiment
      • Part 3: Adding Social Information and New Factors
      • Part 4: Adding Chats
      • Part 5: Adding Bots
    • The Settings File
      • Specifying Login Details
      • Setting player ids via URL queries
      • Connecting Locally to MongoDB
    • The Admin Panel
    • Special Empirica Elements (and how to modify them)
    • Deploying Your Experiment
      • Database
      • Hosting
    • Managing the Data
    • Using Custom Collections
  • Conceptual Overview
    • Structure
    • Game Life Cycle
      • Customising when players submit stages
    • Concepts
    • Randomization & Batches
    • API
  • FAQ
    • I need help!
    • The Processes and Elements of an Empirica Experiment
    • Managing Players and Games
  • Community Demos
    • Guess The Correlation
    • Random Dot Motion
    • Room Assignment
  • Tips & Tricks
    • Helpful Linux Commands
    • Code Editors
  • Links
    • Empirica website
    • Twitter
    • GitHub
Powered by GitBook
On this page
  • A note about Windows 10 Setup
  • A note about macOS Monterey (Apple M1 Chip) Setup

Was this helpful?

  1. Getting Started

Setup

PreviousIntroductionNextWindows WSL Instructions

Last updated 2 years ago

Was this helpful?

  1. Install Node.js via (download and install the LTS bundle on the left)

  2. Install Meteor with instructions at

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

A note about Windows 10 Setup

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

Running Meteor apps on Windows can be unreliable, as apps struggle to install and launch. Whilst stopping and trying again multiple times (as well as making sure there are no processes that slow down the installation of the Meteor files) might work, it is not recommended.

In order to run Empirica reliably in Windows, you will need to enable developer settings within advanced Windows settings and download/install the new version of Windows Subsystem for Linux (WLS2).

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 for community-based technical support on a wide range of topics.

A note about macOS Monterey (Apple M1 Chip) Setup

When using apple's new M1 chip, the minimum Meteor version that you can install is version 2.5.1. This causes an issue with Empirica which uses a specific version of Meteor (1.10.2) as shown below.

This project uses Meteor 1.10.2, which isn't available on this platform. To work with this app on all supported platforms, use meteor update --release METEOR@2.7.3 to pin this app to the newest compatible release.

Do not run the recommended command to update meteor as that would also cause issues.

To resolve this issue, you need to switch from macOS Monterey to macOS Rosetta by running the following command:

arch -x86_64 zsh

Once entered, run the following command to change the meteor version to 1.10.2.

meteor update --release 1.10.2
https://nodejs.org/en/
https://www.meteor.com/install
Creating your experiment
Windows WSL Instructions