yacy_search_server/docker/Readme.md

Yacy Docker image from latest sources

Supported tags and respective Dockerfile links

• latest (Dockerfile)
• lastet-alpine (Dockerfile.alpine)

Getting built image from Docker Hub

docker pull luccioman/yacy

Repository URL : (https://hub.docker.com/r/luccioman/yacy/)

Building image yourself

Using yacy_search_server/docker/Dockerfile :

cd yacy_search_server/docker
docker build .

Image variants

luccioman/yacy:latest

This image is based on latest stable official java image provided by Docker. Embed Yacy compiled from latest git repository sources.

luccioman/yacy:latest-alpine

This image is based on latest stable official Alpine Linux java image provided by Docker. Embed Yacy compiled from latest git repository sources.

Default admin account

login : admin

password : docker

You should modify this default password with page /ConfigAccounts_p.html when exposing publicly your YaCy container.

Usage

First start

Most basic

docker run luccioman/yacy

YaCy web interface is then exposed at http://[container_ip]:8090. You can retrieve the container IP address with docker inspect.

Easier to handle

docker run --name yacy -p 8090:8090 luccioman/yacy

--name option allow easier management of your container (without it, docker automatically generate a new name at each startup).

-p option map host port and container port, allowing web interface access through the usual http://localhost:8090.

Handle persistent data volume

As configured in the Dockerfile, by default yacy data (in /opt/yacy_search_server/DATA) will persist after container stop or deletion, in a volume with an automatically generated id.

Bu you may map a host directory to hold yacy data in container :

docker run -v [/your_host/data/directory]:/opt/yacy_search_server/DATA luccioman/yacy

Or just use a volume label to help identify it later

docker run -v yacy_volume:/opt/yacy_search_server/DATA luccioman/yacy

Note that you can list all docker volumes with :

docker volume ls

As background process

docker run -d luccioman/yacy

Next starts

As attached process

docker start -a yacy

As background process

docker start yacy

Shutdown

• Use "Shutdown" button in administration web interface

• OR run :

  docker exec [your_container_name] /opt/yacy_search_server/stopYACY.sh

License

View license information for the software contained in this image.