INSTALL FAQ

Docker image installation FAQ and troubleshooting

This page covers the common setup path after downloading the OFC Docker image: install Docker Desktop, run the fingerprint tool, paste the machine fingerprint on the license page, download the Docker image and license.json, then run the image and import the license locally.

Current installation flow

1. Payment or Alpha page

Paste the machine fingerprint.

2. Download files

Download the Docker image and license.json.

3. Run image

Load and start it with Docker Desktop.

4. Import license

Import license.json in the local setup screen.

Before installing

Docker Desktop

Install Docker Desktop and confirm that Docker Engine is running.

Docker image

Download the image from the approved delivery page and confirm the file completed downloading.

license.json

Download license.json from the approved page and do not rename or edit it.

API permission

Order-enabled plans need read and trade permissions only. Do not enable withdrawals.

Common installation issues

Docker is not running or the docker command is missing

Open Docker Desktop, wait for Docker Engine to show Running, then reopen the terminal and check:

docker --version
docker info

How do I load the Docker image?

Open the delivery folder and load the image file provided by OFC:

docker load -i ofc-toolkit-image.tar

After loading, run docker images to confirm it appears.

How do I start the container?

If a compose file is included, use:

docker compose up -d

Then run docker ps and open the local URL shown by the container.

license.json validation failed

Confirm the file name is license.json, do not edit it, and make sure it was generated for this machine fingerprint.

Port already in use

Another container or local app may already be using the port. Stop the old container or change the configured port.

Exchange workflow checklist

OKX, Binance, Bybit, Bitget, Gate.io, Pionex, and BingX can require different API permissions and account modes. The common rule is simple: use the least permission needed, never enable withdrawal permission, and test before live use.

OKX

Check API key, secret, passphrase, demo or real mode, account mode, and contract permissions.

Binance

Check spot or futures permissions, testnet or live mode, product access, and IP restrictions.

Bybit

Check unified account mode, derivatives permissions, environment, and leverage settings.

Bitget

Check passphrase, USDT-M access, spot permissions, and risk parameters.

Gate.io

Check market type, settlement currency, order size limits, and API permissions.

Pionex

Confirm which API permissions are available for the account before deciding the workflow.

BingX

Check futures or spot mode, API permissions, IP restrictions, and leverage settings.

Need setup help?

Return to the toolkit and send your operating system, exchange, and intended workflow.

Open toolkit form