Upstream: eclipse-iofog/iofogctl · Development mirror: Datasance/potctl

iofogctl and potctl are dual-flavor CLIs for installing, configuring, and operating ioFog Edge Compute Networks (ECNs). v3.8 is a greenfield release: configuration lives under ~/.iofog/v3, and there is no in-place upgrade path from legacy potctl- or v3.7 deployments.

Release binaries ship for linux (amd64, arm64, armv6, armv7), macOS (amd64, arm64), and Windows (amd64). Built with Go 1.26.4 (see go.mod).

Install — iofogctl

Package repository: iofog.datasance.com

Linux (DEB or RPM):

wget -q -O - https://iofog.datasance.com/iofogctl_installer.sh | sudo bash
sudo apt install -y iofogctl   # Debian/Ubuntu
# or
sudo yum install -y iofogctl   # RHEL/CentOS/Fedora

macOS (Homebrew):

brew tap eclipse-iofog/iofogctl
brew install iofogctl

Install — potctl

Package repository: downloads.datasance.com

Linux (DEB or RPM):

wget -q -O - https://downloads.datasance.com/potctl_installer.sh | sudo bash
sudo apt install -y potctl   # Debian/Ubuntu
# or
sudo yum install -y potctl   # RHEL/CentOS/Fedora

macOS (Homebrew):

brew tap Datasance/potctl
brew install potctl

Edge node agent — edgelet

v3.8 edge nodes run edgelet, not the legacy Java iofog-agent. Deploy edge nodes with the CLI (deploy -f manifest) or install the edgelet binary directly:

curl -fsSL https://github.com/eclipse-iofog/edgelet/releases/download/v1.0.0-rc.6/install.sh -o install.sh
chmod +x install.sh
sudo ./install.sh --version=v1.0.0-rc.6

Eclipse canonical: eclipse-iofog/edgelet · Datasance mirror: Datasance/edgelet

Usage

iofogctl version
iofogctl connect --help
iofogctl deploy -f ecn.yaml
# potctl is the Datasance-flavor equivalent (same commands, different binary name)

Documentation:

• iofogctl: iofog.org
• potctl: docs.datasance.com

Shell autocompletion: iofogctl autocomplete bash (or zsh), then follow the printed instructions.

Build from source

Requires Go 1.26.4+ (matches the Go badge and go.mod). Build outside $GOPATH (Go modules):

make FLAVOR=iofog build       # iofogctl → bin/iofogctl
make FLAVOR=datasance build   # potctl → bin/potctl
# or
make iofogctl
make potctl

Install to $GOPATH/bin:

make FLAVOR=iofog install

Running tests

make test

Unit tests (short mode):

make test-unit

License

EPL-2.0