Skip to content

Latest commit

 

History

History
102 lines (69 loc) · 2.13 KB

DOCKER-COMPOSE.md

File metadata and controls

102 lines (69 loc) · 2.13 KB
Raw

Docker Compose

This project includes shortcuts for running docker compose commands. It uses default.yml but it can also use your own compose file.

  • Requires Compose V2
  • Place a docker-compose.yml file to use your own instead of default.yml
  • Pass COMPOSE=my-compose to use my-compose.yml
make <command> <options>

Options

  • NAMESPACE=chevereto
  • VERSION=4.1
  • EDITION=pro
  • HTTP_PORT=80
  • HTTPS_PORT=443
  • HOSTNAME=localhost
  • HOSTNAME_PATH=/
  • PROTOCOL=http
  • COMPOSE=default
  • TARGET=default

Example:

make up HOSTNAME=que.chevere.org PORT=80

💡 TIP: To ease working with multiple projects use NAMESPACE to pass multiple options stored in a file.

Example:

make up NAMESPACE=yourproject

Compose files

By default it uses default.yml which is intended to be used in production with nginx proxy.

Notes on TARGET

TARGET affects the project name, container basename and tag name.

Target Project name Container basename
default NAMESPACE_chevereto NAMESPACE_chevereto-VERSION
dev NAMESPACE_chevereto-dev NAMESPACE_chevereto-dev-VERSION
any NAMESPACE_chevereto-any NAMESPACE_chevereto-any-VERSION

Project name will also affect volume naming, which will be prefixed with the project name.

Up

make up

Up (daemon)

make up-d

Stop

make stop

Start

make start

Restart

make restart

Down

make down

Down volumes

make down--volumes

Troubleshoot

Check if you are running latest Docker version with Compose V2 docker compose (not docker-compose).

If Docker was included with your Linux distribution check for Install Docker Engine on Linux. Some distributions may be providing old docker engine for LTS compliance, make sure to follow Docker instructions.