ExternalVendorCode/balena-cli
1
0
Fork 0
mirror of https://github.com/balena-io/balena-cli.git synced 2024-12-22 15:02:22 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
The official balena CLI tool.
1,274 Commits 91 Branches 1,083 Tags 51 MiB
TypeScript 97.9%
JavaScript 1.5%
Shell 0.4%
EJS 0.1%
8474ee726c
Go to file
alisondavis17 8474ee726c Update README.md 
Change Support section to point to Forums instead of Gitter
2017-03-09 14:46:20 -08:00
bin Remove unused resin-write bin script 2015-08-19 11:30:48 -04:00
build Filter our devices that do not expose docker socket 2017-03-09 20:54:11 +00:00
doc Docs: fix requirements for resin ssh and resin sync 2017-01-18 18:04:37 +02:00
extras/capitanodoc Regenerate docs 2015-07-07 18:01:25 -04:00
lib Filter our devices that do not expose docker socket 2017-03-09 20:54:11 +00:00
.editorconfig Add editorconfig 2014-10-31 09:49:57 -04:00
.gitignore Add resinrc.yml to gitignore 2015-09-08 09:07:48 +03:00
.hound.yml Change java_script to javascript in hound config 2015-10-19 14:21:10 -04:00
.npmignore Add npmignore 2015-12-04 08:51:28 -04:00
capitanodoc.json Docs: fix requirements for resin ssh and resin sync 2017-01-18 18:04:37 +02:00
CHANGELOG.md 5.3.0 2017-03-03 18:14:48 +02:00
coffeelint.json Add Coffeelint support 2014-10-31 09:48:53 -04:00
gulpfile.coffee Regenerate JS and add header to suppress diff 2017-01-18 18:04:42 +02:00
LICENSE Change license to Apache 2.0 2016-01-03 23:58:51 -04:00
package.json Implement 'resin local logs' 2017-03-08 22:43:23 +00:00
README.md Update README.md 2017-03-09 14:46:20 -08:00
TROUBLESHOOTING.md Document the case where EACCES is thrown during login 2016-03-09 11:03:45 -04:00

README.md

Resin CLI

The official Resin CLI tool.

npm version dependencies Gitter

Requisites

  • NodeJS (at least v0.10)
  • Git
  • The following executables should be correctly installed in your shell environment:
    • ssh: Any recent version of the OpenSSH ssh client (required by resin sync and resin ssh)
    • rsync: >= 2.6.9 (required by resin sync)
Windows Support

resin sync and resin ssh have not been thoroughly tested on the standard Windows cmd.exe shell. We recommend using bash (or a similar) shell, like Bash for Windows 10 or Git for Windows.

If you still want to use cmd.exe you will have to use a package manager like MinGW or chocolatey. For MinGW the steps are:

  1. Install MinGW.
  2. Install the msys-rsync and msys-openssh packages.
  3. Add MinGW to the %PATH% if this hasn't been done by the installer already. The location where the binaries are places is usually C:\MinGW\msys\1.0\bin, but it can vary if you selected a different location in the installer.
  4. Copy your SSH keys to %homedrive%%homepath\.ssh.

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

Plugins

The Resin CLI can be extended with plugins to automate laborious tasks and overall provide a better experience when working with Resin.io. Check the plugin development tutorial to learn how to build your own!

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.

Support

If you're having any problems, 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 in the resin.io forums.

License

The project is licensed under the Apache 2.0 license.