summaryrefslogtreecommitdiff
path: root/scripts/docker/README.md
blob: 101db8377c92b36b117eb183a67adb5eea8d8687 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Soledad Docker Images
=====================

The files in this directory help create a docker image that is usable for
running soledad server and client in an isolated docker context. This is
especially useful for testing purposes as you can limit/reserve a certain
amount of resources for the soledad process, and thus provide a baseline for
comparison of time and resource consumption between distinct runs.

Check the `Dockerfile` for the rules for building the docker image.

Check the `Makefile` for example usage of the files in this directory.


Environment variables for server script
---------------------------------------

If you want to run the image for testing you may pass the following
environment variables for the `files/start-server.sh` script for checking out
a specific branch on the soledad repository:

  SOLEDAD_REMOTE - a git url for a remote repository that is added at run time
                   to the local soledad git repository.

  SOLEDAD_BRANCH - the name of a branch to be checked out from the configured
                   remote repository.

Example:

  docker run \
    --env="SOLEDAD_REMOTE=https://0xacab.org/leap/soledad.git" \
    --env="SOLEDAD_BRANCH=develop" \
    leap/soledad:1.0 /usr/local/soledad/start-server.sh