Home

Installing on Chrome OS

STEP 1: Allow Chrome OS to Install Linux ('Crostini')

1. On your Chromebook, open Settings, then click the hamburger menu at the upper left (looks like three horizontal lines).
2. In the side menu that opens, click the Linux (Beta) option.
3. Go through the process of installing Linux on your Chromebook.

STEP 2: Open Terminal

1. After Linux is installed on your Chromebook, you will notice a new app folder in your overflow menu (where all your app icons live) called Linux apps. Click on this folder and select Terminal.
2. Wait for the Terminal app to open. This might take a few minutes the first time.

STEP 3: Install Zotero Using Terminal Commands

Enter these commands in Terminal to install Zotero 5.0+:

wget -qO- https://github.com/retorquere/zotero-deb/releases/download/apt-get/install.sh | sudo bash
sudo apt update
sudo apt install zotero

Once those finish, you can close the Terminal and go back to the Linux apps folder. You will now see an icon for Zotero, and clicking on it will open the app, as normal. You can then pin the app to your Chrome Launcher.

Step 4: Connector

To use Zotero with the Google Docs integration, you need to install a port forwarding app such as Connection Forwarder. Also, Linux/Crostini must not be running (so close the Zotero app). You then set a forwarding rule as follows:

Protocol: TCP
Source: 127.0.0.1 (Localhost) port 23119 (Source Port, ie connection port from Chrome)
Destination: 127.0.0.1(Localhost) port 8080 (Destination Port, ie target port in Linux/Crostini)

Within the Zotero app, set the Zotero HTTP port to 8080 Edit -> Preference -> Advanced -> Config Editor -> Accept -> extensions.zotero.httpServer.port -> double click and set to 8080.

If you have trouble entering the Port number using the keyboard, try copying and pasting it into there.

Once you have done all these things, you should be good to go.