Files
2025-08-14 13:54:31 +03:00
..
2025-05-08 12:16:23 +03:00
2023-03-10 02:16:28 -04:00
2024-02-20 13:09:09 +03:00
2024-07-26 16:30:45 +03:00
2023-08-22 16:54:53 +03:00
2025-08-14 13:54:31 +03:00
2025-05-08 12:16:23 +03:00
2025-05-08 12:16:23 +03:00
2025-05-08 12:16:23 +03:00

Intro

Deal Module (dm) - the Bitdeals daemon that provides a special interfaces for creating and modifying user accounts and deals.

Running DM docker container

On first run the initialization script will create, a new bitcoin and PGP keys and start the daemon.

Daemon settings may specified by an environment variables. PGP secret key is stored on a Docker volume.

First run example: docker run -i -t -e DM_TESTNET=true -p 127.0.0.1:443:443 bitdeals/apostol-dm - register new user, open WebUI port.

Usage

Here are some example snippets to help you get started creating a container at localhost.

docker-compose

version: "3"
services:
  bitdeals-module:
    image: registry.bitdeals.org/apostol-dm
    environment:
      - DM_TESTNET=true
      - DM_BITCOIN=<address>
      - DM_FEE=<0.1%>
      - DM_FORWEB=http://127.0.0.1
      - |
        DM_PGP_SEC=
        -----BEGIN PGP PRIVATE KEY BLOCK-----
        <key>
        -----END PGP PRIVATE KEY BLOCK-----

    volumes:
      - dm:/home/dm
    ports:
      - 127.0.0.1:4999:4999 
      - 127.0.0.1:80:80
      - 127.0.0.1:443:443
volumes:
  dm:

docker cli

docker run -d \
  -e DM_TESTNET=true \
  -e DM_BITCOIN=<address> \
  -e DM_FEE=0.1% \
  -e DM_PGP_SEC="$(gpg2 --armor --export-secret-key Account_URL)" \
  -p 127.0.0.1:4999:4999 \
  -p 127.0.0.1:80:80 \
  -p 127.0.0.1:443:443 \
  -v /home/dm/:/home/dm/ \ 
  registry.bitdeals.org/apostol-dm

Parameters

Container images are configured using parameters passed at runtime.

Parameter Function
-p 80 WebUI port
-p 443 WebUI port
-p 4999 dm API port (API documentation)
-e DM_ACCOUNT_URL= Set Account_URL for a new account registration. Format: http[s]://<host>[:<port>]
-e DM_BITCOIN= User account bitcoin address. Will be created if empty.
-e DM_BITDEALS_PGP_FINGERPRINT= Force to get BitDeals PGP key by fingerprint from keyserver. Default: none
-e DM_FEE= User fee for created deals. You MUST indicate the sign "%" for a percentage of the deal amount or FIXED value in satoshi. Default: 0.1%
-e DM_FORWEB= dm host for dm Web app (the host should be accessable from your browser). Default: http://127.0.0.1
-e DM_LC_ALL= Set locale for dm. Default: en_US.UTF-8
-e DM_PGP_PASSWORD= User PGP key password.
-e DM_PGP_SEC= Variable with ASCII armored PGP user secret key. Will be created if empty (with Account_URL in the key details).
-e DM_TESTNET= Enable bitcoin testnet mode. Default: false
-e DM_TZ= Set timezone for dm. Default: Etc/UTC
-e DM_PRIVATEDASH= Enable Web app authorization on bitdeals.org for account private dashboard access. Default: false
-e DM_PRIVACY_MODE= Block currency rates from coinbase.com. Default: false
-e DM_WEB_LANG= Set interface language for dm WebUI: ru or en. Default: en