balena-cli/README.md

89 lines
2.8 KiB
Markdown
Raw Normal View History

Resin CLI
=========
2014-12-09 19:20:22 +00:00
> The official Resin CLI tool.
2016-01-11 15:26:34 +00:00
[![npm version](https://badge.fury.io/js/resin-cli.svg)](http://badge.fury.io/js/resin-cli)
[![dependencies](https://david-dm.org/resin-io/resin-cli.svg)](https://david-dm.org/resin-io/resin-cli.svg)
[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/resin-io/chat)
2014-12-09 19:20:22 +00:00
Requisites
----------
2014-12-09 19:20:22 +00:00
- [NodeJS](https://nodejs.org) (at least v0.10)
- [Git](https://git-scm.com)
2014-12-09 19:20:22 +00:00
Getting Started
---------------
2014-12-09 19:20:22 +00:00
### Installing
2014-12-09 19:20:22 +00:00
This might require elevated privileges in some environments.
2014-12-09 19:20:22 +00:00
```sh
$ npm install --global --production resin-cli
2014-12-09 19:20:22 +00:00
```
### List available commands
```sh
$ resin help
```
### Run the quickstart wizard
2014-12-09 19:20:22 +00:00
```sh
$ resin quickstart
2014-12-09 19:20:22 +00:00
```
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.
2016-01-13 04:13:07 +00:00
### 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.
2016-01-22 14:14:55 +00:00
### 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:
```sh
$ rm -rf $HOME/.resin/cache
```
Or in Windows:
```sh
> del /s /q %UserProfile%\_resin\cache
```
Support
-------
If you're having any problem, check our [troubleshooting guide](https://github.com/resin-io/resin-cli/blob/master/TROUBLESHOOTING.md) and if your problem is not addressed there, please [raise an issue](https://github.com/resin-io/resin-cli/issues/new) 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](https://gitter.im/resin-io/chat).
License
-------
2016-01-04 03:58:51 +00:00
The project is licensed under the Apache 2.0 license.