2.8 KiB
Resin CLI
The official Resin CLI tool.
Requisites
Getting Started
Installing
This might require elevated privileges in some environments.
$ npm install --global --production resin-cli
List available commands
$ resin help
Run the quickstart wizard
$ resin quickstart
FAQ
Where is my configuration file?
The per-user configuration file lives in $HOME/.resinrc.yml or %UserProfile%\_resinrc.yml, in Unix based operating systems and Windows respectively.
The Resin CLI also attempts to read a resinrc.yml file in the current directory, which takes precedence over the per-user configuration file.
How do I point the Resin CLI to staging?
The easiest way is to set the RESINRC_RESIN_URL=resinstaging.io environment variable.
Alternatively, you can edit your configuration file and set resinUrl: resinstaging.io to persist this setting.
How do I make the Resin CLI persist data in another directory?
The Resin CLI persists your session token, as well as cached images in $HOME/.resin or %UserProfile%\_resin.
Pointing the Resin CLI to persist data in another location is necessary in certain environments, like a server, where there is no home directory, or a device running Resin OS, which erases all data after a restart.
You can accomplish this by setting RESINRC_DATA_DIRECTORY=/opt/resin or adding dataDirectory: /opt/resin to your configuration file, replacing /opt/resin with your desired directory.
Why do I get Invalid MBR boot signature when configuring a device?
This error, accompanied with something like: Expected 0xAA55, but saw 0x29FE usually indicates a corrupted device operating system image in the cache, due to bad a internet connection during the download process.
Try clearing the cache with the following command and trying again:
$ rm -rf $HOME/.resin/cache
Or in Windows:
> del /s /q %UserProfile%\_resin\cache
Support
If you're having any problem, check our troubleshooting guide and if your problem is not addressed there, please raise an issue on GitHub and the Resin.io team will be happy to help.
You can also get in touch with us at our public Gitter chat channel.
License
The project is licensed under the Apache 2.0 license.