Docker Deployment (Recommended)

This guide covers deploying Epusdt with the official Docker image using Docker Compose or docker run.

No manual .env is required for the first boot. The recommended Docker layout is to mount a dedicated host directory and point EPUSDT_CONFIG to a file inside it. That keeps config, the default SQLite database, and runtime data persistent without shadowing files from the image.

Prerequisites

• Docker and Docker Compose installed

Steps

1. Create a directory

mkdir epusdt && cd epusdt

2. Create docker-compose.yaml

cat <<EOF > docker-compose.yaml
services:
  epusdt:
    image: gmwallet/epusdt:latest
    restart: always
    environment:
      EPUSDT_CONFIG: /data/.env
    ports:
      - "8000:8000"
    volumes:
      - ./data:/data
EOF

Why this layout:

• /data/.env stores the generated config file
• /data/epusdt.db becomes the default primary SQLite database
• /data/runtime/ stores runtime SQLite data and logs by default
• the container image under /app stays untouched, so upgrades do not get masked by an old /app volume

3. Start the service

docker compose up -d

4. Complete the install wizard

Open http://your-server-ip:8000 in your browser. The install wizard currently focuses on these fields:

• app_name
• app_uri
• http_bind_addr
• http_bind_port
• runtime_root_path
• log_save_path
• order_expiration_time
• order_notice_max_retry

Docker binding requirement

For Docker deployments, set http_bind_addr to 0.0.0.0.

Do not use 127.0.0.1. The current installer default can still show 127.0.0.1, but if you save that value in Docker, Epusdt will only listen on 127.0.0.1:8000 inside the container after restart, so the published Docker port and reverse proxy access can fail.

If you already finished the wizard with the wrong value, edit ./data/.env on the host and change:

http_listen=127.0.0.1:8000

into:

http_listen=0.0.0.0:8000

Then restart the container:

docker restart epusdt

Once submitted, the service restarts automatically and is ready to use.

---

Alternative: docker run quick start

docker run -d \
  --name epusdt \
  --restart always \
  -e EPUSDT_CONFIG=/data/.env \
  -p 8000:8000 \
  -v $(pwd)/data:/data \
  gmwallet/epusdt:latest

Then open http://your-server-ip:8000 to complete setup.

---

File-based config management (optional)

If you prefer to review or edit the generated config later, use the same ./data directory created above. After installation, the config file is stored at:

./data/.env

You can edit it directly on the host, then restart the container:

docker restart epusdt

---

Notes

• After setup completes, merchant credentials and runtime options are managed from the admin panel
• For new integrations, use the merchant pid + secret_key created in the admin panel
• Avoid mounting the entire /app directory. It can cause old files from a previous container volume to shadow the new image during upgrades.
• To upgrade: docker pull gmwallet/epusdt:latest && docker compose up -d