Tooling and Ecosystem Problems

Can't find arc - PATH issues

You need to make sure that arc is in your system's PATH variable, and that your current shell has sourced the PATH after any changes.

The installer script we provide as part of the install instructions does this automatically on macOS and most Linux distros. The .msi based installer for Windows should have added this during install.

Windows

In this example we assume that the downloaded arc.exe binary is in a sensible location, or the default installer location C:\Program Files\electricui-arc\.

For this example, ours is in a manual location C:\Projects\tools\electricui\arc.exe, but these instructions apply when you put the binary anywhere else.

  • Open the Start Menu
  • Type environment variables into search and select the option called "Edit the system environment variables"
  • The "System Properties" window will open, navigate to "Advanced", then click the "Environment Variables..."
  • Under the "System variables" section, select the Path variable. Click "Edit..."
  • You'll see a list of locations which are in your PATH. Create a new entry, and add the fully resolved location of the arc.exe binary you downloaded.
    • On our machine, we put the file in a tools directory C:\Projects\tools\electricui.
  • Click "OK" to save. Close the editor window and open a new shell.
  • Test that the added variable worked by typing arc info into the shell.

Linux

For this example we assume you've opted to manually download the arc binary and place in a directory called "electricui" in a your system's opt folder, the file's fully resolved location is /opt/electricui/arc

  • Open a terminal window.
  • Find your system/shell's relevant user configuration file. This is typically ~/.profile, though some people prefer using ~/.bashrc for shell specific configuration.
  • Open it with a text editor like nano or vi
  • Add the following export to the file export PATH="/opt/electricui:$PATH"
  • Save the file, exit the editor. Restart your shell, or run source ~/.profile to enact the changes in the current shell.

macOS

  • Open a terminal window.
  • We will add the location of the arc binary to the /etc/paths file, use your editor of choice to edit the file
    • sudo nano /etc/paths and enter your password at the challenge.
  • Add the location of the arc binary to the bottom of the file, for us, this was /Users/scott/tools/electricui
  • Open a new shell and run arc info to check everything works.

Or, edit your .bash_profile file with sudo nano ~/.bash_profile and use standard bash export syntax export PATH="/Users/scott/tools/electricui:$PATH"

My node or yarn versions are too old, or conflict against other projects

Is there any reason why you can't update them? If using your distribution's provided versions, consider uninstalling them with your package manager and following our install instructions. Often the OS provided version for a given programming language isn't ideal to develop with, and you might be familiar with tooling in languages like Python or Rust which multi-version development easier.

nvm allows you to switch between node versions, we recommend it in our install instructions.

Once you have nvm installed, you can install different versions with nvm install 12, view installed versions with nvm ls, and switch to an installed version with nvm use 12.

arc can't see servers

Check you can see our see our server: ping eui.io. If you can't, does your internet connection work (our entire website runs from local cache).

If you are on a restrictive corporate network, try configuring the proxy settings?

todo

I already have a program called arc installed

In the rare situation that you have a conflict against our arc tool and other software, alias eui-arc against the installed file:

Instructions haven't written yet.

If you are updating an existing installation, you can install over the top of previous versions of arc without worry.