To make a long story short:

1) Install container with dachs and awstats on your laptop

(you need the docker app installed on your machine)

cd somewhere_convenient
git clone
      (install container the first time) 

cd docker-dachs/
cd dockerfiles/
docker-compose up -d
     (will start docker)
docker exec -ti dachs bash
     (will start dachs 2.5)

2a) Install example service (for CSV input)

cd /var/gavo/inputs
     (then clone the example:)
git clone
cd planets

From here you can then ingest the data: 

dachs val q.rd
dachs imp q.rd 

2b) Install your service from scratch

cd /var/gavo/inputs
mkdir dummy_service
cd dummy_service
dachs start epntap
     (writes a generic q.rd template you can edit)

Then, remind to backup your work before exiting Docker - at least on your machine (outside Docker) or possibly on voparis-gitlab.
Keep voparis-gitlab updated with your q.rd and a sample data file.

2c) Install a service from another directory

Edit file docker-compose.yml to add this last line:

        - "${DACHS_LOGS_PATH:-./tmp/logs}:/var/gavo/logs"
        - "path_to_service/dummy_service:/var/gavo/inputs/dummy_service"

(For instance, if located in docker-dachs:)
         - "$PWD/dummy_service:/var/gavo/inputs/dummy_service"

The first time this will copy the service files in directory dockerfiles/

  where you can edit with your host editor - changes are reflected in the guest system.

(you can add new services this way in your docker - beware that everything is reconstructed on restart, so you'll have to ingest again the previous ones)

3) Access the local service from your browser

Go to
To see service tables:
To query tables (SQL-like):

See presentations from Carlos and Chloé (day 3) for details: 2021-vespa-implementation-workshop:

  • No labels