https://github.com/hartza-capital/docker-ib-gateway
Dockerized Interactive Brokers Gateway with IBC for automated trading. Multi-channel releases, VNC support, and cloud-ready deployment.
https://github.com/hartza-capital/docker-ib-gateway
algorithmic-trading api-gateway automated-trading-strategies aws-ecs cloud-native container containerization financial-trading fintech headless ib-gateway ibc interactive-brokers-api kubernetes production-ready quant trading-strategies vnc
Last synced: 3 months ago
JSON representation
Dockerized Interactive Brokers Gateway with IBC for automated trading. Multi-channel releases, VNC support, and cloud-ready deployment.
- Host: GitHub
- URL: https://github.com/hartza-capital/docker-ib-gateway
- Owner: hartza-capital
- Created: 2021-11-11T13:56:22.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-18T07:45:44.000Z (4 months ago)
- Last Synced: 2025-06-18T08:36:36.057Z (4 months ago)
- Topics: algorithmic-trading, api-gateway, automated-trading-strategies, aws-ecs, cloud-native, container, containerization, financial-trading, fintech, headless, ib-gateway, ibc, interactive-brokers-api, kubernetes, production-ready, quant, trading-strategies, vnc
- Language: Shell
- Homepage: https://quay.io/repository/hartza-capital/ib-gateway?tab=tags
- Size: 143 KB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker IB Gateway
## What is it?
A project that containerizes **IB Gateway** (Interactive Brokers Gateway) with **IBC** (Interactive Brokers Controller) to enable automated trading without a graphical interface.
This project is based on [extrange/ibkr-docker](https://github.com/extrange/ibkr-docker) but with a different approach by **Hartza Capital**.
## Build Status
## Main Features
- **Fully containerized**: IB Gateway + IBC in a complete Docker container
- **Automated startup**: Gateway startup is handled by [IBC (Interactive Brokers Controller)](https://github.com/IbcAlpha/IBC)
- **Auto-restart**: Automatic restart on disconnection (like IB's daily disconnect)
- **VNC support**: GUI access via VNC for debugging
- **Multi-channel**: Support for `stable`, `latest`, and `nightly` versions
- **`stable` & `latest`**: Infinite lifespan until replaced by a new version. Previous versions expire 3 months after replacement
- **`nightly`**: Temporary builds (3-day lifespan) for testing advanced versions
- **Python scripts**: Debugging tools in debug to test API connections
- **Weekly releases**: Automated releases on `stable` and `latest` channels every Sunday
- **Cloud-ready**: Works perfectly on AWS ECS/Kubernetes. Hartza Capital uses a customized version on AWS ECS in production
- **Extensible**: You can add your own custom scripts within the container (though this is generally considered a bad practice, it's the simplest approach given the gateway's security criticality and IBKR gateway's rigidity)
## Project Structure
- **build.sh**: Automated build script that handles different channels
- **docker-compose.yaml**: Configuration to start the container easily
- **Dockerfile**: Container build with IB Gateway and IBC
- **config.ini**: IBC configuration for automation
- **GitHub Actions**: Automated CI/CD to build and publish images to [Quay.io](https://quay.io/repository/hartza-capital/ib-gateway?tab=tags)
## Usage
The project allows running IB Gateway in headless mode for automated trading strategies, with optional VNC access on port 5900 and API on ports 4001/4002.