Atymctl Installation

This guide explains how to install the Atymctl on different operating systems.

---

Installing the Atymctl

The Atymctl is available through platform-specific package managers for easy installation and updates.

Linux

1. Add the APT repository:

   echo "deb [trusted=yes] http://apt.prod.atym.io/atymctl stable main" | sudo tee /etc/apt/sources.list.d/atymctl.list

2. Update package lists:

   sudo apt update

3. Install Atymctl:

   sudo apt install atymctl

4. Verify installation:

   atymctl version

macOS

1. Add the Atymctl Homebrew tap:

   brew tap atym-io/homebrew-repo

2. Install Atymctl:

   brew install atymctl

3. Verify installation:

   atymctl version

Windows

1. Configure Chocolatey source:

   choco source add -n=atymctl -s="https://choco.prod.atym.io/chocolatey" --priority=1

2. Install Atymctl:

   choco install atymctl

3. Verify installation:

   atymctl version

---

Upgrading the CLI

To update the Atymctl to the latest version:

Linux

sudo apt update && sudo apt upgrade atymctl

macOS

brew upgrade atymctl

Windows

choco upgrade atymctl

---

Uninstalling the CLI

If you need to remove the Atymctl:

Linux

sudo apt remove atymctl

To also remove the repository configuration:

sudo rm /etc/apt/sources.list.d/atymctl.list

macOS

brew uninstall atymctl

To also remove the tap:

brew untap atym-io/homebrew-repo

Windows

choco uninstall atymctl

To also remove the source:

choco source remove -n=atymctl

---

Troubleshooting

Command Not Found

If you receive a "command not found" error after installation:

Linux

1. Verify the package is installed:

   dpkg -l | grep atymctl

2. Check if the binary is in your PATH:

   which atymctl

3. If needed, restart your terminal session or source your shell configuration.

macOS

1. Verify the package is installed:

   brew list | grep atymctl

2. Check if the binary is in your PATH:

   which atymctl

3. If needed, restart your terminal session or run:

   source ~/.zshrc  # or ~/.bash_profile

Windows

1. Verify the package is installed:

   choco list --local-only atymctl

2. Try restarting your PowerShell or Command Prompt window

3. If the issue persists, check your system PATH environment variable includes the Chocolatey bin directory (usually C:\ProgramData\chocolatey\bin)

Permission Errors

Linux

If you encounter permission errors during installation, ensure you're using sudo:

sudo apt install atymctl

macOS

Homebrew installations should not require sudo. If you encounter permission issues:

1. Check Homebrew's permissions:

   brew doctor

2. Follow any recommendations provided

Windows

Ensure you're running PowerShell or Command Prompt as Administrator:

1. Right-click on PowerShell/Command Prompt
2. Select "Run as Administrator"
3. Run the installation command again

---

For additional help, contact support@atym.io.