LogoLogo
  • Introduction
  • Getting Started
    • Setup
      • Windows WSL Instructions (new)
      • Windows WSL Instructions
      • Linux Instructions
    • Creating your experiment
    • Running your experiment
    • Updating your experiment
  • Conceptual Overview
    • Game Life Cycle
      • Customising when players submit stages
    • Concepts
    • Randomization & Batches
    • API
  • Guides
    • V2 Migration
    • Managing the Data
    • Special Empirica Components
    • The Admin Panel
    • Deploying Your Experiment
      • Ubuntu tutorial
  • Tutorials
    • Beginner Experiment: Prisoner's Dilemma
      • Part 1: Before you start
      • Part 2: Creating the Experiment in Empirica
      • Part 3: Getting Accustomed to the Code
      • Part 4: Coding the Prisoner's Dilemma Game
        • Part 4.1: Removing example code
        • Part 4.2: Intro Text
        • Part 4.3: Set up the game stages
        • Part 4.4: Build the "Choice" React Component
        • Part 4.5: Build the "Result" React Component
        • Part 4.6: Compute the Score
      • Part 5: Customizing the experiment
        • Part 5.1: Changing the number of rounds
        • Part 5.2: Turning the chat on and off
      • Part 6: Deployment
  • FAQ
    • I need help!
    • The Processes and Elements of an Empirica Experiment
    • Managing Players and Games
  • Resources
    • Helpful Linux Commands
    • Code Editors
    • Javascript and React
  • Links
    • Empirica website
    • Twitter
    • GitHub
Powered by GitBook
On this page
  • Check the current version of your experiment
  • Updating Empirica in your Experiment
  • Change to a specific version in your experiment
  • Updating the Empirica command

Was this helpful?

Edit on GitHub
Export as PDF
  1. Getting Started

Updating your experiment

PreviousRunning your experimentNextGame Life Cycle

Last updated 1 year ago

Was this helpful?

When new features or bug fixes are added to Empirica, you should try to upgrade to the latest version.

Before upgrading, you can head over to the to verify that there are no BREAKING CHANGES between your current and the latest versions.

To check the current version of your experiment, see Check the current version of your experiment.

Check the current version of your experiment

At the root of your experiment, run empirica version:

$ empirica version
Version: v1.0.0-rc.24
SHA:     bc4184e
Build:   169
Branch:  main
Time:    2022-12-28T08:21:58Z

Client:  1.0.0-rc.24
Server:  1.0.0-rc.24

Updating Empirica in your Experiment

You can update the packages in your experiment by running the following command at the root of your experiment:

$ empirica upgrade

Within your current experiment, this will upgrade both the empirica command and the npm packages used in client/ and server/. This will not upgrade the empirica command globally. To upgrade the empirica command globally, see Updating the Empirica command

Change to a specific version in your experiment

If you need to upgrade (or downgrade) to a specific version of Empirica, you can pass the exact version like so:

$ empirica upgrade --version "v1.2.3"

You can also choose to only upgrade the command line or the npm packages individually with either:

$ empirica upgrade --commandOnly
$ empirica upgrade --packagesOnly

Updating the Empirica command

To upgrade the empirica command globally (outside any existing experiment), run the following:

$ empirica upgrade --global
Empirica Release Notes