zotero-server

A simple Zotero 5.0 server setup based on Docker.

zotero-server uses a special dataserver fork until all required customizations will be merged into the main repository.

The full zotero-server will have all required packages to run a fully fledged Zotero server. Currently there are:

• dataserver
• tinymce-clean-server
• stream-server
• citeproc-node
• translation-server

Setup and run

git clone https://github.com/mrtcode/zotero-server
cd zotero-server
make configure

Now configuration scripts are generated. Customize them and then start building:

make build

To run Elasticsearch, it needs an increased vm_max_map_count setting on your Docker host:

sysctl -w vm.max_map_count=262144

Start all services:

make up

Wait until all databases are started and then initialize data:

make init-mysql
make init-elasticsearch
make init-localstack-s3
make init-localstack-sns

A test user will be created. You can use it with Zotero client:

testuser:test

zotero-server is now accessible on

172.13.0.1:80

Test

make test

Stop

make down

Manually control services

All services you can see in docker-compose.yml. Each of them can be controlled directly with docker-compose.

docker-compose up/down/build [service name]

Attach console:

docker-compose exec [service-name] bash

Amazon Web Services

Some Zotero functions depend on Amazon services:

• S3 - file uploads
• SNS - file uploads, updated items notifications
• SQS - updated items notifications

zotero-server currently uses localstack to emulate AWS services.

Configure Zotero 5.0 client

var ZOTERO_CONFIG = {
	GUID: 'zotero@chnm.gmu.edu',
	ID: 'zotero', // used for db filename, etc.
	CLIENT_NAME: 'Zotero',
	DOMAIN_NAME: '172.13.0.1',
	REPOSITORY_URL: '',
	REPOSITORY_CHECK_INTERVAL: 86400, // 24 hours
	REPOSITORY_RETRY_INTERVAL: 3600, // 1 hour
	BASE_URI: 'http://172.13.0.1/',
	WWW_BASE_URL: '',
	PROXY_AUTH_URL: '',
	API_URL: 'http://172.13.0.1/',
	STREAMING_URL: 'ws://172.13.0.1/',
	API_VERSION: 3,
	PREF_BRANCH: 'extensions.zotero.',
	BOOKMARKLET_ORIGIN: '',
	HTTP_BOOKMARKLET_ORIGIN: '',
	BOOKMARKLET_URL: '',
	PDF_TOOLS_URL: "https://www.zotero.org/download/xpdf/"
};

EXPORTED_SYMBOLS = ["ZOTERO_CONFIG"];

Tools

phpmyadmin

http://172.13.0.20/

elasticsearch-head

http://172.13.0.21:9100/?base_uri=http://172.13.0.7:9200