Docker

Warning

by default the server is not secured at all

  • Authentication is disabled (run-parameter --env "NEO4J_AUTH=none")
  • make sure to set your firewall rules to keep the server in you zone only

Build MaSeMiWa-Docker-Image yourself

  1. open a terminal in the root folder of the repository (the Dockerfile is located here)
  2. create docker image masemiwa, i.e. with docker build -t masemiwa .

Run MaSeMiWa-Docker-Image

  • run the docker image with something like the code from the file docker/start_docker.sh in the root of the repository

    docker run --rm \
       --detach \
       --name masemiwa \
       --user "$(id -u):$(id -g)" \
       --volume "/my/local/folder/with/masemiwa/config:/opt/config" \
       --volume "/my/local/folder/with/masemiwa/logs:/opt/logs" \
       --publish 8080:4242 \
       masemiwa
    • --rm to remove the container after running from cache
    • --detach to ru in background mode
    • --name naming of the container
    • --user to use the current users id and group id for writing files in the mounted volumes
    • --volume to bind a local directory or any docker-volume to save the logs and read the configuration, please replace /my/local/folder/with/masemiwa/ accordingly
      • ⚠ make sure, the local directories exist and belong to the same user and group as the process in the docker container. With the --user option, you need to use the same IDs.
    • --publish to map the internal listener to a port on your machine

  • the server in the container will listen on port 4242 for SEEK requests

Hints

  • stop the container with docker stop masemiwa
  • see console output with docker logs --follow masemiwa
  • get a root bash inside the running container with docker exec -u 0 -it masemiwa bash

Connect MaSeMiWa and MaSyMoS Morre with Docker

  • requirements
    • MaSeMiWa is running in Docker, see above
      • run start_docker.sh → creates Docker Container masemiwa
    • MaSyMoS Morre is running with Neo4J in Docker, see here
      • run run-neo4j-server.sh → creates Docker Container masymos_neo4j

  • create Docker Network and add the two machines

    docker network create masy
docker network connect masy masymos_neo4j
docker network connect masy masemiwa
  • hints
    • if you rename something or if you use other ports, make sure, to update the MaSeMiWa configuration