Leto

Docker (Mac, OS X)

First, you need to install docker if you do not already have it. You can use the direct links provided on this page and click your way through the installer.

The installation should be straightforward as it behaves like any other installer. However, if you need more precise instructions, they are available on the docker website.

Once docker is installed, launch the Docker Quickstart Terminal (Mac: use Spotlight). This will take care of setting up the environment so that everything works. You have to type all your Zorba commands in this terminal.

Inside this terminal, you need (only once) to download Zorba by typing the following instruction (the container is available here for further reference):

$ docker pull fcavalieri/zorba

After a few minutes, Zorba is ready.

You can execute your first query like so:

$ docker run --rm fcavalieri/zorba -q 1+1

For convenience, you can create a bash script named "zorba" in a directory that is in your PATH variable, with the appropriate execution permissions and the following content. Replace "username" with your user name (or the complete path /Users/username with anything path of your choice).

docker run --rm -v /Users/username:/queries fcavalieri/zorba $*

This gives you a direct zorba executable:

$ zorba -q 1+1

If you now create an XQuery file at /Users/username/query.xq containing, say:

let $value as xs:string := string(//foo)
return { "Foo": $value }

And an XML file at /Users/username/file.xml containing:

<foo>Hello, World!</foo>

Then you can execute it like so:

$ zorba -q query.xq -f --context-item file.xml

Docker (Windows, Non-Ubuntu distributions)

First, you need to install docker if you do not already have it. You can use the direct links provided on this page and click your way through the installer.

The installation should be straightforward as it behaves like any other installer. However, if you need more precise instructions, they are available on the docker website.

Once docker is installed, launch the Docker Quickstart Terminal (Mac: use Spotlight). This will take care of setting up the environment so that everything works. You have to type all your Zorba commands in this terminal.

Inside this terminal, you need (only once) to download Zorba by typing the following instruction (the container is available here for further reference):

$ docker pull fcavalieri/zorba

After a few minutes, Zorba is ready.

You can execute your first query like so:

$ docker run --rm fcavalieri/zorba -q 1+1

(More to come on Windows)

Ubuntu

Ubuntu packages for Zorba and for all external modules are available through: ppa:fcavalieri/zorba.
For adding this repository to your list of know repositories use:

sudo add-apt-repository ppa:fcavalieri/zorba
sudo apt-get update

For installing Zorba use:

sudo apt-get install zorba

And for installing the external modules use:

sudo apt-get install zorba-${modulename}-module

Kratos

Debian Installation

Linux Debian packages for Zorba and for all external modules are available through: ppa:juan457/zorba.

For adding this repository to your list of know repositories use:

sudo add-apt-repository ppa:juan457/zorba
sudo apt-get update

For installing Zorba use:

sudo apt-get install zorba

And for installing the external modules use:

sudo apt-get install zorba-${modulename}-module