Skip to main content

Overview

Docker support is maintained by Cachet users from within the community.

Getting Started With Docker Compose

Quickly launch Cachet, NGINX and PostgreSQL docker images with docker-compose.
  1. Clone the repository:
    git clone https://github.com/cachethq/Docker.git cachet-docker
    cd cachet-docker
    
  2. Edit the docker-compose.yml file to specify your ENV variables.
  3. To build an image containing a specific Cachet release, change the cachet_ver ARG in the docker-compose.yml file:
     cachet:
        build:
          context: .
          args:
            - cachet_ver=v2.3.10
    
  4. Build and run the image:
    docker-compose build
    docker-compose up
    
  5. Continue to configure Cachet in your web browser by navigating to your Docker host’s IP address.

Running Cachet Docker Container Manually

Run a DB container:
docker run --name postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -d postgres:9.5
Run Cachet:
docker run -d --name cachet --link postgres -e DB_DRIVER=pgsql -e DB_HOST=postgres -e DB_DATABASE=postgres -e DB_USERNAME=postgres -e DB_PASSWORD=postgres -d cachethq/docker:latest
Now go to http://<ipdockerisboundto>:8000/setup and have fun!

Enabling SSL

This is commonly achieved by running Nginx with your certificates on your Docker host, service or load balancers in-front of the running container, or by adding your custom SSL certificates and configuration to the supplied Nginx configuration.

Notes

  • cachethq/docker runs on port 8000 by default. This is exposed on host port 80 when using docker-compose.
  • The masterbranch andcachethq/docker:latestDocker automated build are a work in progress / development version of the upstream https://github.com/CachetHQ/Cachet project. As such,masterorlatest` should not be used in a production environment as it may change at anytime. We strongly recommend specifying a stable Cachet Release at build time as mentioned in step 3 above.
I