Installation

This guide covers everything you need to install and configure the Datafye CLI on your system.

Platform Support

The Datafye CLI officially supports macOS and Linux. Windows users can run the CLI via WSL (Windows Subsystem for Linux).

Windows users: Click here for WSL setup instructions

Setting up WSL for Windows

If you don't already have WSL installed, follow these steps:

1. Install WSL: Open PowerShell or Windows Command Prompt in administrator mode and run:

   wsl --install

   This will install Ubuntu by default.

2. Restart your computer when prompted

3. Launch WSL: Open the Start menu, search for "Ubuntu" (or your chosen Linux distribution), and click to launch

4. Complete initial setup: Create a username and password when prompted

Once WSL is installed and running, continue with the installation instructions below (WSL provides a Linux environment, so follow the Linux instructions).

For more details, see Microsoft's WSL installation guide.

Tip: Consider using Windows Terminal for a better terminal experience.

Prerequisites

Before installing the Datafye CLI, ensure your system meets the following requirements.

Java 17+

The Datafye CLI requires Java 17 or newer to run.

Verify Java installation:

java -version

You should see version 17.x.y or higher. If not, download and install Java from:

• Oracle JDK Downloads

• OpenJDK

Using DATAFYE_CLI_JAVA_HOME (Optional)

If you cannot add Java 17+ to your system PATH, you can set the DATAFYE_CLI_JAVA_HOME environment variable to point to your Java 17+ installation:

# macOS/Linux - add to ~/.bash_profile or ~/.zprofile
export DATAFYE_CLI_JAVA_HOME=/path/to/your/jdk17

# Verify
$DATAFYE_CLI_JAVA_HOME/bin/java -version

The Datafye CLI looks for Java in this order:

1. If java is in PATH and is version 17+, use it

2. Otherwise, if DATAFYE_CLI_JAVA_HOME is set and points to Java 17+, use it

3. Otherwise, exit with an error

Docker (Required for Local Deployments)

Local (Standalone) deployments require Docker Desktop installed and running.

Requirements:

• Docker Desktop 4.0+ (or Docker Engine 20.10+ on Linux)

• Docker daemon running and accessible

• 8GB+ RAM available

• 20GB+ free disk space

Verify Docker installation:

docker --version
docker ps  # Should list running containers (or show empty list)

Download Docker Desktop:

• Docker Desktop for Mac

• Docker Desktop for Windows

• Docker Engine for Linux

On macOS and Windows, ensure Docker Desktop is started before running datafye commands for local deployments. The Docker daemon must be running.

AWS Setup (Required for AWS Deployments)

If you plan to provision Distributed Self-managed deployments in AWS, you'll need to configure AWS access.

Complete AWS setup guide: See AWS Setup for detailed instructions on installing the AWS CLI and configuring authentication using IAM credentials, IAM Identity Center (SSO), or other AWS authentication methods.

Installing the Datafye CLI

The Datafye CLI can be installed system-wide (requires sudo) or user-local (no sudo required).

System-wide Installation (Recommended)

System-wide installation places the CLI in /usr/local/bin and requires sudo:

curl -fsSL https://downloads.n5corp.com/datafye/cli/latest/install.sh | sudo bash

This makes the datafye command available to all users on the system.

Install a specific version:

curl -fsSL https://downloads.n5corp.com/datafye/cli/1.0.0/install.sh | sudo bash

User-local Installation (No sudo)

If you don't have sudo access or prefer a user-local installation:

curl -fsSL https://downloads.n5corp.com/datafye/cli/latest/install.sh | bash -s -- --no-root

This installs the CLI to $HOME/.local/bin.

Important: If you see a message about $HOME/.local/bin not being on your PATH, add it to your shell profile:

# For bash - add to ~/.bash_profile or ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"

# For zsh - add to ~/.zprofile or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Then reload your shell configuration:

# For bash
source ~/.bash_profile

# For zsh
source ~/.zprofile

Verifying Installation

After installation, verify the CLI is working:

datafye

Expected output:

Datafye -- Institutional Grade Trading for Everyone

Datafye CLI is Datafye's command line tool. Try:

datafye help commands        list the top level commands
datafye help <command>       help on a specific command

Initial Configuration (Optional)

The CLI can be configured with defaults to avoid specifying common options on every command.

The CLI configuration file is located at ~/.datafye/config.yaml. You can create this file manually or let the CLI create it on first run.

Example configuration:

# Default deployment model
default_deployment: standalone

# Cloud provider settings for distributed deployments
cloud:
  provider: aws
  account_id: "123456789012"
  region: us-east-1

# Datafye account credentials
credentials:
  api_key: "your-api-key"

# Default descriptor paths
descriptors:
  data: ./descriptors/data.yaml
  algo: ./descriptors/algo.yaml
  broker: ./descriptors/broker.yaml

Updating the CLI

To update to the latest version, re-run the installation command:

System-wide update:

curl -fsSL https://downloads.n5corp.com/datafye/cli/latest/install.sh | sudo bash

User-local update:

curl -fsSL https://downloads.n5corp.com/datafye/cli/latest/install.sh | bash -s -- --no-root

The installer will detect the existing installation and upgrade it.

Uninstalling the CLI

System-wide uninstall:

sudo rm /usr/local/bin/datafye

User-local uninstall:

rm $HOME/.local/bin/datafye

Remove configuration (optional):

rm -rf ~/.datafye

Troubleshooting

"java: command not found"

Problem: The CLI cannot find Java.

Solution:

1. Verify Java 17+ is installed: java -version

2. If not installed, install Java from the links above

3. If installed but not in PATH, set DATAFYE_CLI_JAVA_HOME (see above)

"Docker daemon is not running"

Problem: Docker is not running (only affects local deployments).

Solution:

1. Start Docker Desktop (macOS/Windows)

2. Or start Docker daemon (Linux): sudo systemctl start docker

3. Verify: docker ps

AWS Configuration Issues

Problem: AWS credentials not configured or invalid (only affects AWS deployments).

Solution: See the AWS Setup guide for detailed AWS configuration and troubleshooting.

"Permission denied" during installation

Problem: Installation script needs elevated permissions.

Solution:

• For system-wide install: Use sudo with the install command

• For user-local install: Use the --no-root flag and ensure $HOME/.local/bin is in your PATH

CLI command shows "command not found"

Problem: The CLI is not in your PATH.

Solution:

• For system-wide install: /usr/local/bin should be in PATH by default

• For user-local install: Add $HOME/.local/bin to PATH (see above)

• Verify PATH: echo $PATH

• Reload shell: source ~/.bash_profile or source ~/.zprofile

Next Steps

Now that you have the CLI installed:

• Learn CLI concepts — Read The Datafye CLI to understand how the CLI works

• Understand descriptors — Review Deployment Descriptors to learn about configuration files

• Get started — Choose your scenario in Choose Your Path

• Browse commands — See CLI Commands for detailed command reference

Getting Help

If you encounter issues not covered in this guide:

• Run datafye help for command help

• Check the CLI Commands reference

• Contact Datafye support