Installation
Install ASReview
ASReview software requires an installation of Python 3.7 or later. Detailed step-by-step instructions to install Python (and ASReview) are available for Windows and macOS/Linux users.
Install the ASReview software with Pip by running the following command in the CMD.exe (Windows) or Terminal (MacOS/Linux):
pip install asreview
Start the application with the following command (in CMD.exe or Terminal):
asreview lab
The ASReview LAB software starts in the browser. For more options on starting ASReview LAB, see Start ASReview LAB.
Note
See Troubleshooting for common problems during installation.
Tip
For users with Apple M1 computers, if you experience problems, follow the instructions.
Upgrade ASReview
Upgrade ASReview software with
pip install --upgrade asreview
Uninstall ASReview
Remove ASReview with
pip uninstall asreview
Enter y
to confirm.
Warning
Note that your project files will not delete with this action. You find them in the .asreview folder in your home folder.
Server Installation
It is possible to run the ASReview software on a server or custom domain. Use the flags ip and port for configuration. ASReview should only be used in closed networks.
asreview lab --port 5555 --ip xxx.x.x.xx
Warning
Don’t use the development server in production. Read the Flask documentation about deploying a Flask app to production.
Install with Docker
ASReview is also available as a Docker container. Make sure you have Docker installed on your machine.
To install and start ASReview LAB at http://localhost:5000, run the following:
docker run -p 5000:5000 ghcr.io/asreview/asreview:latest lab
More advanced command line options can be given afterward, like this:
docker run -p 9000:9000 ghcr.io/asreview/asreview lab --port 9000
Tip
ASReview LAB is now installed. Open the URL in your host web browser:
http://localhost:5000
and get started.
Mount local volume
To mount the container to your local project folder (or any other local folder), the -v flag can be used. To do so, adjust path-to-your-folder to your local folder. When a project folder is specified, ASReview LAB will store and load all its projects from this folder. Note that multiple containers can access the same folder.
docker run -p 5000:5000 -v path-to-your-folder:/project_folder ghcr.io/asreview/asreview lab
Named container
To make the usage easier, you can create a named container like the following:
docker create --name asreview-lab -p 5000:5000 -v path-to-your-folder:/project_folder ghcr.io/asreview/asreview lab
To start asreview, enter:
docker start asreview
To stop it, just use stop instead of start. You can also check which images are running with docker ps.
Customize the image
If you want to add more extensions, or build the Docker image yourself, check the file Dockerfile <https://github.com/ghcr.io/asreview/asreview/tree/master/Dockerfiles>. Modify it as you see fit, and then build and run the image with:
docker build -t asreview/asreview:custom .
docker run -p 5000:5000 ghcr.io/asreview/asreview:custom lab