Install and download

When to use this

You need the gg / gg.exe binary to host modules and expose them as Grafts. The Quick Start tutorials use Docker; this page covers native installs and other distribution channels.

Prerequisites

A supported OS: Windows, Linux, or macOS
For hosting .NET, Java, Python, etc.: the target runtime installed on the machine (see CLI reference)

After install, use First run and Vision — includes Vision screenshots for install commands and Try it out.

Download options

GitHub releases (recommended for direct download)

Download the latest binary for your platform:

github.com/grft-dev/graftcode-gateway/releases

Extract and run:

# Linux / macOS
chmod +x gg
./gg --help

# Windows
gg.exe --help

Graftcode Portal wizard

Sign in to portal.graftcode.com
Create or open a project
Use the Gateway setup wizard to download GG for your platform and obtain your Project Key

See Project Key and Registry URL.

Package managers

Chocolatey (Windows): install the graftcode-gateway package if published to your feed
APT (Linux): when available in your distribution or internal repository

Docker

Many teams run GG in a container. The Quick Start – Expose Backend tutorial includes a ready-made Docker workflow.

Verify installation

./gg --help

Start with a module (positional argument or --modules):

./gg ./MyLibrary.dll --port 8888 --httpPort 8889

Open Graftcode Vision in a browser (default HTTP port 81 unless you changed --httpPort):

http://localhost:8889/vision

See First run and Graftcode Vision.

Common mistakes

Mistake	Fix
Port 80 requires admin on Windows/Linux	Use `--port 8888 --httpPort 8889`
GG scans wrong files in current directory	Pass module path explicitly: `./gg ./MyApp.dll`
Wrong runtime for module	Set `--runtime netcore`, `java`, `python`, etc.