BibSpace is an Online Bibtex Publications Management Software for Authors and Research Groups.

⚠️ This repository is now archived and will be no longer maintained.

• See INSTALL.md

To run BibSpace tests (inside Docker), run the following commands.

docker-compose build
docker-compose  -f docker-compose.yml -f docker-compose.test.yml up

To run BibSpace in production mode, run the following commands:

docker-compose build
docker-compose -f docker-compose.yml up -d

That's it! Point you browser to http://localhost:8083/ to open BibSpace.

You may stop the container with

docker-compose down

The MySQL data is stored in db_data, whereas preferences and stats in json_data.

1. Make backup
2. Replace code with the code from a newer version:

git clone --branch <version> https://github.com/vikin91/BibSpace.git

Whereas <version> equals the name of a branch or release tag, for example: v0.5.4.

3. (Optional) Restore backup if any data got lost.

1. Make backup
2. Stop Docker containers docker-compose down
3. Download docker-compose.yml file from Github
4. Change the image version of BibSpace in docker-compose.yml Locate the following part and remove the build part.

  bibspace:
  build:
    context: .
    dockerfile: Dockerfile
  depends_on:
    - db

And add the image definition with respective version. For version 0.6.0 this will look as follows:

  bibspace:
  image: bibspace:0.6.0
  depends_on:
    - db

4. Run with docker-compose up -d
5. (Optional) Restore backup if any data got lost.

1. Important: Update to version 0.5.3 or 0.5.4 first to enable JSON backups.
2. Backup your data to the JSON format and make sure that data can be restored correctly.
3. Replace code with version 0.6.0 and restore data from the JSON backup.