FutuOpenD Deploy¶

Run FutuOpenD — the local gateway for Futu's trading API — in Docker.

This repo provides Docker Compose configurations for running FutuOpenD. The image is built by the futuopend project.

Features¶

• Single and multi-instance deployment via Docker Compose
• Support for both x86_64 (amd64) and ARM (arm64) architectures
• Multiple image variants: Ubuntu, Rocky Linux, CentOS
• Environment variable-based configuration
• Health monitoring with auto-restart
• Backup and restore scripts for persistent data

Quick Start¶

See the Quick Start guide to get up and running.

Documentation¶

• Quick Start Guide
• Platform Options
• Image Variants
• Scripts Reference
• Multi-Instance Deployment
• API Protocol Reference
• Configuration Reference
• Security Hardening Guide

Support¶

Ask questions via GitHub Discussions. Report bugs using the issue tracker.

Troubleshooting¶

Container fails to start with "FutuOpenD not found"

Make sure you have pulled the image:

docker pull shing1211/futuopend:latest

Verify your .env has FUTU_ACCOUNT set:

grep FUTU_ACCOUNT .env

Health check failing on ARM (Raspberry Pi)

ARM builds use QEMU emulation and may take longer to start. Increase start_period in the compose file.

For latency-sensitive trading on Raspberry Pi, consider installing box64 on the host.

Connection refused on ports 11113/11114

Check the container is running:

docker compose ps

Check logs:

docker compose logs futuopend

Verify ports are not in use:

lsof -i :11113

Remember-login keeps prompting for verification

Normal on first run or after a network change. Submit the code via Telnet — see First-Time Login.

RSA key not accepted for trading

Ensure the key file is mounted at /run/secrets/rsa_key.txt inside the container and has permissions 600:

chmod 600 secrets/rsa_key.txt