Install docker and docker compose

When using tellusr you should have the latest version of docker compose installed, as the yaml specification is changing rapidly:

If you are installing on an ubuntu server you may install the docker engine and docker compose by following these instructions instead:

Create a TellusR user with docker access

sudo adduser tellusr
sudo usermod -aG docker tellusr
sudo su - tellusr

Quick deploy of TellusR

curl -s https://<DOWNLOAD_HOST>/ | bash -s install

(Please contact TellusR for the download host.)

This will download TellusR components from the docker hub. A configuration file named tellusr.config and a docker-compose.yml file is added to the directory $HOME/tellusr. The tellusr.config file must comply with .env format of docker compose:

The tellusr.config will look something like this:




# TELLUSR_SOLR_URL="http://solr:8983/solr"

# TELLUSR_SETUP_CONFIGSET="$HOME/tellusr/configset"

# Added version 4.0-RC1 at Mon, 29 Jan 2024 16:52:07 +0000 by 

Entries beginning with # is commented out, and you need to uncomment them if you want to override the defaults. If you only need semantic search in Norwegian it is a good idea to define NLP_LANGUAGES=no, as the English dictionary requires a lot of resources. If you are running TellusR on your local machine TELLUSR_RESTART_POLICY=no will ensure that it does not restart automatically when you reboot. If you want to connect to a Solr instance that is not controlled by this setup you could do so by defining TELLUSR_PROFILE=external_solr and making TELLUSR_SOLR_URL point to the Solr instance you want to use.

Start TellusR

During installation the script is put int the $HOME/tellusr/bin directory.

To start TellusR and create your first project use the following commands:

Navigate to the tellusr directory:

cd $HOME/tellusr

To start tellusr do:

bin/ up

To create a project with the name do:

bin/ create <project>

Please replace with the name of your project. This will create a solr collection with the same name as the project (found in $HOME/tellusr/configset) to Solr. A tellusr project acts as an ID for a collection of indexed documents, and the documents in two different project are disjoint. The documents you upload to TellusR can be organized in one or more “projects”. Each project can have its own configuration settings governing indexing, storage, and search behaviour.

You may, for convenience, add the script to the PATH by adding the following snippet to $HOME/.bashrc.

export PATH=$PATH:$HOME/tellusr/bin

Accessing the dashboard

When the installation is complete the TellusR Dashboard will be available on port 8900. If you are on the same machine you can access it at:

The interactive openapi documentation for the TellusR API will be available on:

You may expose them to port 80 with $HOME/tellusr/bin/ proxy up. This will set up authentication with username tellusr and password TellusRSwings.

Importing data into TellusR

See the API section on how to import data.