Ask or search…
K
Links

1 - Installation

Deploy Memphis over Docker using Docker compose

Requirements

Resource
Version / Quantity
Docker Engine
17.03 and above
Docker compose
v2 and above
CPU
1 CPU
Memory
4GB
Storage
6GB

Getting started

Step 1: Run one of the following commands

Stable -
curl -s https://memphisdev.github.io/memphis-docker/docker-compose.yml -o docker-compose.yml && docker compose -f docker-compose.yml -p memphis up
Latest -
curl -s https://memphisdev.github.io/memphis-docker/docker-compose-latest.yml -o docker-compose-latest.yml && docker compose -f docker-compose-latest.yml -p memphis up
Output:
[+] Running 3/3
⠿ Container memphis-memphis-1 Creating 0.2s 0.2s 0.2s
⠿ Container memphis-memphis-metadata-1 Creating 0.2s
⠿ memphis-memphis-rest-gateway-1 0.2s

Deployed Containers

  • memphis-1: The broker itself which acts as the data storage layer. That is the component that stores and controls the ingested messages and their entire lifecycle management.
  • memphis-metadata-1: Responsible for storing the platform metadata only, such as general information, monitoring, GUI state, and pointers to dead-letter messages. The metadata store uses Postgres.
  • memphis-rest-gateway-1: Responsible for exposing Memphis management and data ingestion through REST requests.

Appendix A: Install Memphis using predefined parameters

Currently, you can use this for creating users during deployment.

Deploy Memphis using the modified docker-compose file:

docker compose -f docker-compose-dev-with-users.yml -p memphis up

Creating users

Integrate the user list into the docker-compose file within Memphis variables:

(Based on Memphis password policy: at least 8 characters long, contains both uppercase and lowercase, and at least one number and one special character(!?-@#$%):
docker-compose-dev-with-users.yml
1
environment:
2
ROOT_PASSWORD: memphis
3
DOCKER_ENV: true
4
ENV: staging
5
USER_PASS_BASED_AUTH: true
6
CONNECTION_TOKEN: memphis
7
METADATA_DB_HOST: memphis-metadata
8
INITIAL_CONFIG_FILE: |
9
users:
10
mgmt:
11
- user: admin
12
password: Admin123456!
13
- user: test_mgmt
14
password: Test123456!
15
- user: test
16
password: Test123456@
17
client:
18
- user: test_app
19
password: Test123456!@
20
- user: test_app2
21
password: Test123456@!
Refer to the example file for guidance: example/docker-compose-dev-with-users.yml
Last modified 2mo ago