Skip to content

Latest commit

 

History

History
71 lines (56 loc) · 2.58 KB

README-docker.md

File metadata and controls

71 lines (56 loc) · 2.58 KB
Raw

Tate-Server - Requires mazacoind!

Tate Server provides electrum SPV services for lightweight clients for MZC

This image will install dependencies and tate-server from mazaclub sources

Based on phusion/baseimage - this image uses /sbin/my_init as the ENTRYPOINT

  • /sbin/my_init will start /etc/service/tate-server/run and restart if it crashes
  • my_init and 'run' will start /app/start.sh will will construct /etc/tate.conf from environment variables.

Usage

A simple start script is provided in the github source repo as an example.

This image expects to find your mazacoind blockdata and mazacoin.conf in /home/maza/.mazacoin and be owned by UID:GID 2211:2211 (maza:maza)

  • This image has VOLUMES at
    • /home/maza
    • /var/tate-server
  • It's highly recommended to use host bindmounts for data permanence.
    • -v /full/host/path:/home/maza
  • If you run mazacoind in a separate image on the same host, and don't use coreos/flannel
    • --link mazacoind_container:mazacoind will expose mazacoind as host "mazacoind"
    • It is preferred to not have mazacoind RPC ports exposed to the host network - use flanneld or --link
  • If you server tate data via SSL, be sure to mount certs!
    • -v /some/path/to/certs:/app/certs
    • default is tate.pem and tate.key

The startup script for tate-server provided will acquire the values needed to configure tate.conf from environment variables

These can be easily set in your docker run statement:

docker run -d \ 
  -h "${HOSTNAME}" \
  --name=${NAME} \
  --restart=always \
  --link ${GROUP}_mazacoind:mazacoind \
  -p 50002:50002 \ 
  -p 8000:8000 \
  -p 50001:50001 \
  -e USER=maza \
  -e HOSTNAME=your.external.fqdn \
  -e MAZACOIND=your-mazacoind.local \
  -v ${HOST_DATA_PREFIX}/certs:/app/certs \
  -v ${HOST_DATA_PREFIX}/mazacoind:${MAZADIR} \
  -v ${HOST_DATA_PREFIX}/tate-data:${DATA_VOLDIR} \ 
  mazaclub/tate-server

The following variables can be set with additional "-e VAR=value " lines in the docker run statement. Defaults are provided.

USER=${USER:-maza}
TATE_HOSTNAME=${TATE_HOSTNAME:-${HOSTNAME}}
TATE_PORT=${TATE_PORT:-50001}
TATE_SSLPORT=${TATE_SSL_PORT:-50002}
MAZACOIND=${MAZACOIND:-mazacoind}
MAZADIR=${MAZADIR:-/home/${USER}/.mazacoin}
RPCPORT=${RPCPORT:-12832}
RPCUSER=${RPCUSER:-$(grep rpcuser ${MAZADIR}/mazacoin.conf |awk -F= '{print $2}')}
RPCPASSWORD=${RPCPASSWORD:-$(grep rpcpassword ${MAZADIR}/mazacoin.conf |awk -F= '{print $2}')}