Skip to content

Home

Jump to bottom
Silvan Heller edited this page Sep 23, 2020 · 23 revisions

Welcome to the Vitrivr NG, the user interface component in the vitrivr stack. The NG stands for 'Angular' or 'Next generation'.

Vitrivr NG is a web-based user interface developed to be used with the latest version if Cineast. It allows the user to browse in and retrieve from mixed multimedia collections.

Getting started

First, simply clone the repository

git clone https://github.com/vitrivr/vitrivr-ng.git

For development, you will require NodeJS and the npm package manager. Once npm is available on your machine, you can install Angular CLI globally using the following command in your console:

sudo npm install -g @angular/cli

Then, install the dependencies (you might need to apt install build-essential first) using

npm install

That's it. Now you should be ready to run Vitrivr NG!

Running Locally

You can simply start a server on your command line using ng serve

Deploying

You can use ng build since this is an angular project. Copy the folder to wherever you want to serve the files from. Alternatively, We provide a deploy-script. For instance, to deploy to your local apache instance, use ./deploy.sh /var/www/html.

Deploying with an apache instance on ubuntu

One of the most common setup-scenarios is performing a clean setup on an ubuntu machine. Therefore, we provide full setup instructions here.

  • First, install apache2: sudo apt install -y apache2
  • Modify permissions so you don't have to deploy with sudo: sudo chmod 777 /var/www/html/
  • Remove the index.html file put there by default (otherwise non-sudo execution of the deploy-script gets stuck): sudo rm /var/www/html/index.html
  • Run the deploy-script ./deploy.sh /var/www/html/
  • Remember to create symlinks to thumbnails / objects.

Configure

The configuration of Vitrivr NG can be made through the src/config.json file. Most importantly, you have to adjust the api.host and api.port settings so that they point to a running instance of Cineast. Furthermore, you have to adjust the URLs under resources.host_thumbnails and resources.host_object. All references to thumbnails and media files will be resolved relative to those locations.

A detailed description of the configuration file and its fields can be found on the Configuration page.

Clone this wiki locally