The below commands are documented specifically for Linux/Mac. If you're running on Windows, the commands are the same, but you will just need to remove the sudo from the front of the commands and open a "Command Prompt" as Administrator (right click to see this option).

Most commands need to be run as a "root" (or admin) user.


Get help

To learn more about a command, run remoteit help:

sudo remoteit help add
# or
sudo remoteit add -h


Global flags

  • --json / -j - to output any command in JSON format

  • --verbose / -v - to output more insight, helpful when you come across issues


General usage

Signing out

sudo remoteit signout

Note that you do not need to be signed into after you initially setup your Device, so it is safe to signout. You will need to sign back in if you need to add/remove Services or perform other actions that require signin.


Learn about CLI configuration

To learn exactly where is putting its configuration, binaries, logs and other general system information, you can run the info command to get a detailed output of this information:

sudo remoteit info


Manage system service

Setting up a Device configures a system Service that runs our software on boot (or login if running as a non-root user). This Service can be managed using the service command:

sudo remoteit system -h
sudo remoteit system status
sudo remoteit system uninstall


Scan your network

sudo remoteit scan

# Output results in JSON
sudo remoteit scan --json # or just -j


Manage tools requires some other tools to be installed, including our tools connectd, muxer, and demuxer. These get installed automatically for you when you signin or setup a new Device. However, there may be cases where you want to manage them yourself.

# See all options
sudo remoteit tools

# Install tools if missing
sudo remoteit tools install

# Update all tools
sudo remoteit tools install --update # or just -u


Specify a different configuration path


Unless you have a good reason to do this, you probably should not use this command flag.

If for some reason you need to use a different path for configuration the defaults, you can pass a --config/-c flag when running a command to use a different path.

sudo remoteit signin --config path/to/my/config.json

Note that you will have to pass in this path for every command in which you want to use this config file otherwise commands default to using the default config location. You can define the environment variable REMOTEIT_CONFIG_PATH="..." to set the default config path to use for all commands.



If you need to remove your Device, you can run remoteit uninstall. This will remove everything from you system related to including all your configuration. Note that this does not remove your Device or Services from directly, but you can do this in the web portal.

Be careful with this command as it is permanent.

If you uninstall, you will have to re-configure your Device if you want to add back to your system.

This uninstalls everything but the remoteit CLI binary.

Was this article helpful?
0 out of 0 found this helpful