Skip to content

Commit

Permalink
Update readme (#488)
Browse files Browse the repository at this point in the history
* Update README.md

* docker-compose.local.yml added.
  • Loading branch information
AmirRajabii authored Dec 24, 2024
1 parent ae57215 commit e0be8e5
Show file tree
Hide file tree
Showing 3 changed files with 111 additions and 6 deletions.
1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@ target/

### Other files ###
.env
docker-compose.local.yml
docker-compose-otc.local.yml

docker-compose.legacy.yml
Expand Down
54 changes: 49 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<p align="center">
<br />
<img width="256px" src="https://demo.opex.dev/static/media/opexLogoPlus.2858c980.svg" alt="Opex" title="Opex">
<img width="256px" src="https://opex.dev/assets/img/opex/opexLogoPlus.svg" alt="Opex" title="Opex">
<br />
</p>

Expand All @@ -22,14 +22,15 @@ microservice project work as a vanilla core for running cryptocurrency exchanges
<a href="https://github.com/opexdev/core/issues" target="_blank">
<img src="https://img.shields.io/github/issues/opexdev/core? style=flat-square"/>
</a>
<a href="https://demo.opex.dev" target="_blank">
<img src="https://img.shields.io/website?url=https%3A%2F%2Fdemo.opex.dev&logo=react&label=demo.opex.dev" style=flat-square/>
<a href="https://app.opex.dev" target="_blank">
<img src="https://img.shields.io/website?url=https://app.opex.dev&logo=react&label=app.opex.dev" style=flat-square/>
</a>
</p>

## Contents

- [Build and Run](#build-and-run)
- [Environment Variables](#environment-variables)
- [Live Demo](#live-demo)
- [Architecture Overview](#overview)
- [How to Contribute](#how-to-contribute)
Expand All @@ -41,13 +42,56 @@ You need to have [Maven](https://maven.apache.org) and [Docker](https://www.dock

1. Clone the repository `git clone https://github.com/opexdev/core.git`
1. Run `cd core`
1. You will need to create and add the following [Environment Variables](#environment-variables) to the `.env` file located in the root of your project
1. Run `mvn clean install` command.
1. Run `docker-compose up --build`.
1. Run `docker compose -f .\docker-compose.yml -f .\docker-compose.override.yml -f .\docker-compose.build.yml -f .\docker-compose.local.yml up -d --build`.
1. Run `docker ps` to see if every service is running.


## <a name="environment-variables"></a>Environment Variables
```
APP_NAME=Opex-local
APP_BASE_URL=localhost:8080
PANEL_PASS=admin
BACKEND_USER=admin
SMTP_PASS=x
OPEX_ADMIN_KEYCLOAK_CLIENT_SECRET=x
API_KEY_CLIENT_SECRET=x
KEYCLOAK_FRONTEND_URL=http://localhost:8083/auth
KEYCLOAK_ADMIN_URL=http://localhost:8083/auth
KEYCLOAK_VERIFY_REDIRECT_URL=http://localhost:8080/verify
KEYCLOAK_FORGOT_REDIRECT_URL=http://localhost:8080/forgot
PREFERENCES=preferences.yml
WHITELIST_REGISTER_ENABLED=true
WHITELIST_LOGIN_ENABLED=true
WALLET_BACKUP_ENABLED=false
TAG=debug
```
| Variable | Description |
| :-------- | :------------------------- |
| SMTP_PASS | An SMTP password is a password used to access an email account's |
| OPEX_ADMIN_KEYCLOAK_CLIENT_SECRET | Ignore this |
| API_KEY_CLIENT_SECRET |(Please do this after starting the project, then rebuild and run the process again.) </br>1. Go to http://localhost:8083/auth/admin/master/console/#/realms/opex/clients </br>2. Click on Opex-api-key </br>3. In the Credentials section, click on Regenerate Secret </br>4. Copy the generated secret and paste it into this section |
| PREFERENCES | For the initialization |

## <a name="live-demo"></a>Live Demo

Deployed at [demo.opex.dev](https://demo.opex.dev).
Deployed at [app.opex.dev](https://app.opex.dev).

## <a name="overview"></a>Architecture Overview

Expand Down
62 changes: 62 additions & 0 deletions docker-compose.local.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
version: '3.8'
services:
zookeeper:
user: "root"
kafka-1:
user: "root"
kafka-2:
user: "root"
kafka-3:
user: "root"
vault:
ports:
- "8200:8200"
consul:
ports:
- "8500:8500"
- "8300:8300"
- "8600:8600"
redis:
ports:
- "6379:6379"
redis-cache:
ports:
- "6380:6379"
akhq:
ports:
- "127.0.0.1:10100:8080"
accountant:
ports:
- "127.0.0.1:8089:8080"
- "127.0.0.1:1045:5005"
eventlog:
ports:
- "127.0.0.1:8090:8080"
matching-engine:
ports:
- "127.0.0.1:8092:8080"
- "127.0.0.1:1046:5005"
matching-gateway:
ports:
- "127.0.0.1:8093:8080"
- "127.0.0.1:1047:5005"
auth:
ports:
- "127.0.0.1:8083:8080"
- "127.0.0.1:1048:5005"
wallet:
ports:
- "127.0.0.1:8091:8080"
- "127.0.0.1:1049:5005"
market:
ports:
- "127.0.0.1:8096:8080"
- "127.0.0.1:1056:5005"
api:
ports:
- "127.0.0.1:8094:8080"
- "127.0.0.1:1050:5005"
bc-gateway:
ports:
- "0.0.0.0:8095:8080"
- "127.0.0.1:1052:5005"

0 comments on commit e0be8e5

Please sign in to comment.