Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 165 lines (94 sloc) 6.676 kb
6c2ecad @AvianFlu [test] Add .travis.yml and Travis badge to readme.
AvianFlu authored
1 # jitsu [![Build Status](https://secure.travis-ci.org/nodejitsu/jitsu.png)](http://travis-ci.org/nodejitsu/jitsu)
780a590 @Marak [misc] Updating ReadMe
Marak authored
2 *Flawless command line deployment of Node.js apps to the cloud*
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
3
2614d97 @Marak [ux] Reduced color usage. Added assets folder. Moved / updated Screensho...
Marak authored
4 <img src="https://github.com/nodejitsu/jitsu/raw/master/assets/jitsu.png"/>
0974136 @Marak [misc] Added new screenshot
Marak authored
5
d2739f2 @Marak [misc] Updating Readme
Marak authored
6 ## Overview
7
56d60ff @mmalecki [doc] Fix ALL the links!
mmalecki authored
8 [Jitsu](https://github.com/nodejitsu/jitsu) is a [Command Line Tool (CLI)](http://en.wikipedia.org/wiki/Command-line_interface) for managing and deploying Node.js applications. It's open-source and easy to use. [We've](https://github.com/nodejitsu) designed `jitsu` to be suitable for command line beginners, but still be powerful and extensible enough for production usage.
d2739f2 @Marak [misc] Updating Readme
Marak authored
9
a23f504 @Marak [docs] Updating ReadMe
Marak authored
10 `jitsu` requires `npm`, the [node package manager](http://npmjs.org).
d2739f2 @Marak [misc] Updating Readme
Marak authored
11
a23f504 @Marak [docs] Updating ReadMe
Marak authored
12 ## One-line npm install
d2739f2 @Marak [misc] Updating Readme
Marak authored
13
a23f504 @Marak [docs] Updating ReadMe
Marak authored
14 [sudo] curl http://npmjs.org/install.sh | sh
15
16
17 ## One-line jitsu install
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
18
69835cd @Marak [docs] Updated ReadMe
Marak authored
19 [sudo] npm install jitsu -g
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
20
7db22b4 @Marak [misc] Updating ReadMe
Marak authored
21 ## Features
22
e4915fe @zemanel Fix typo on README.md
zemanel authored
23 `jitsu` is built on some amazing technologies which we've been actively building with the community since 2009. `jitsu` is fully extendable and extremely modular ( see [Libraries](#Libraries) section ).
d2739f2 @Marak [misc] Updating Readme
Marak authored
24
7db22b4 @Marak [misc] Updating ReadMe
Marak authored
25 - Allows for seamless deployment of your Node.js applications to the cloud
56d60ff @mmalecki [doc] Fix ALL the links!
mmalecki authored
26 - Ships with use-full boilerplates and sample applications through [Node Apps](https://github.com/nodeapps) project integration
915b0b7 @Marak [misc] Updating ReadMe
Marak authored
27 - Fully supports `npm` dependency resolution on deployment to [Nodejitsu](http://nodejitsu.com)
56d60ff @mmalecki [doc] Fix ALL the links!
mmalecki authored
28 - Full support of [Nodejitu's API](https://github.com/nodejitsu/nodejitsu-api) ( a plethora of node.js goodies )
29 - Integrated multi-level multi-transport logging support via [Winston](https://github.com/flatiron/winston)
30 - Too many to list... seek [further knowledge ](https://github.com/nodejitsu/handbook) or just try it out!
780a590 @Marak [misc] Updating ReadMe
Marak authored
31
a23f504 @Marak [docs] Updating ReadMe
Marak authored
32
33 # One-Line Node App Installation
34
de884e6 @Marak [docs] Minor updates to README
Marak authored
35 **If you don't have an application yet, you can use one of ours!**
a23f504 @Marak [docs] Updating ReadMe
Marak authored
36
37 jitsu install
38
39 # One-Line Node App Deployment
b87d33c @Marak [docs] Updating ReadMe
Marak authored
40
780a590 @Marak [misc] Updating ReadMe
Marak authored
41 jitsu deploy
42
de884e6 @Marak [docs] Minor updates to README
Marak authored
43 *( inside the path of your Node.js application )*
44
b87d33c @Marak [docs] Updating ReadMe
Marak authored
45
780a590 @Marak [misc] Updating ReadMe
Marak authored
46 This will create a new application, package.json, and deploy your path to [Nodejitsu](http://nodejitsu.com). If it's your first deployment, you'll be prompted for some information such as *subdomain* and *start script* but it's really easy and we promise it will only take a few seconds.
47
b87d33c @Marak [docs] Updating ReadMe
Marak authored
48 If you have any issues deploying your node.js application please feel free to open up an issue on the [Github Issues](https://github.com/nodejitsu/jitsu/issues) section of this page, we'll have someone get back to you in a flash!
780a590 @Marak [misc] Updating ReadMe
Marak authored
49
7db22b4 @Marak [misc] Updating ReadMe
Marak authored
50 ## Usage
ab8d16a @Marak [docs] Cleaning up
Marak authored
51
a8b187b @Marak [misc] Updating Readme
Marak authored
52 `jitsu` is mostly self documenting. After installation, run the `jitsu` command from your command line.
ccaea9f @Marak [misc] Updating ReadMe
Marak authored
53
54 If it's your first time using `jitsu`, you will be prompted to login with an existing account or create a new account.
55
2614d97 @Marak [ux] Reduced color usage. Added assets folder. Moved / updated Screensho...
Marak authored
56 <img src="https://github.com/nodejitsu/jitsu/raw/master/assets/login.png"/>
ccaea9f @Marak [misc] Updating ReadMe
Marak authored
57
a8b187b @Marak [misc] Updating Readme
Marak authored
58 ## After you've logged in, you can start deploying apps immediately!
f7d3313 @Marak [misc] Adde screenshot of prompt
Marak authored
59
60
ab8d16a @Marak [docs] Cleaning up
Marak authored
61
780a590 @Marak [misc] Updating ReadMe
Marak authored
62 ## Command Line Usage
ab8d16a @Marak [docs] Cleaning up
Marak authored
63
992e62a @Marak Updating Readme
Marak authored
64 `jitsu` is mostly self-documenting. Try any of these commands to get started.
65
780a590 @Marak [misc] Updating ReadMe
Marak authored
66
67 **Usage:**
68
69 jitsu <resource> <action> <param1> <param2> ...
70
71 **Common Commands:**
0dc265e @nicoreed [docs] added docs for the signup and login commands
nicoreed authored
72
73 *To sign up for [Nodejitsu](http://nodejitsu.com)*
74
75 jitsu signup
76
77 *To log into [Nodejitsu](http://nodejitsu.com)*
78
79 jitsu login
80
de884e6 @Marak [docs] Minor updates to README
Marak authored
81 *To install a pre-built application*
82
83 jitsu install
84
780a590 @Marak [misc] Updating ReadMe
Marak authored
85 *Deploys current path to [Nodejitsu](http://nodejitsu.com)*
86
87 jitsu deploy
88
89 *Creates a new application on [Nodejitsu](http://nodejitsu.com)*
90
91 jitsu create
92
93 *Lists all applications for the current user*
94
95 jitsu list
96
97 *Additional Commands*
98
99 jitsu apps
100 jitsu snapshots
101 jitsu users
04816e5 @nicoreed [docs] added the logs and database commands to README.md
nicoreed authored
102 jitsu logs
103 jitsu databases
780a590 @Marak [misc] Updating ReadMe
Marak authored
104 jitsu conf
105 jitsu logout
106
107
108
ab8d16a @Marak [docs] Cleaning up
Marak authored
109 ### Help
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
110
b87d33c @Marak [docs] Updating ReadMe
Marak authored
111 `jitsu` is mostly self documenting. We suggest just trying it out. All commands will yield friendly messages if you specify incorrect parameters. If you find anything difficult to use, please open up a [Github issue](https://github.com/nodejitsu/jitsu/issues) or pull request!
780a590 @Marak [misc] Updating ReadMe
Marak authored
112
e2cdf20 @indexzero [doc] Update README.md
indexzero authored
113 jitsu help
114 jitsu help apps
115 jitsu help snapshots
116 jitsu help users
04816e5 @nicoreed [docs] added the logs and database commands to README.md
nicoreed authored
117 jitsu help logs
118 jitsu help databases
e2cdf20 @indexzero [doc] Update README.md
indexzero authored
119 jitsu help config
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
120
7e002ad @Marak [misc] Added .jitsuconf section to Readme
Marak authored
121 ## .jitsuconf file
122
b87d33c @Marak [docs] Updating ReadMe
Marak authored
123 All configuration data for your local `jitsu` install is located in the *.jitsuconf* file in your home directory. Directly modifying this file is not really advised. You should be able to make all configuration changes via:
7e002ad @Marak [misc] Added .jitsuconf section to Readme
Marak authored
124
1e4183e @mmalecki [fix docs] Fix indent in code blocks
mmalecki authored
125 jitsu config
cbe727d @dominictarr [doc] add --localconf and --jitsuconf docs to README.md
dominictarr authored
126
127 If you need to have multiple configuration files, use --localconf or --jitsuconf options.
128
129 ##jitsu options
130
1e4183e @mmalecki [fix docs] Fix indent in code blocks
mmalecki authored
131 jitsu [commands] [options]
132
133 --version print jitsu version and exit
134 --localconf search for .jitsuconf file in ./ and then parent directories
135 --jitsuconf [file] specify file to load configuration from
136 --noanalyze skip require-analyzer: do not attempt to dynamicially detect dependencies
f7d3313 @Marak [misc] Adde screenshot of prompt
Marak authored
137
079055a @pksunkara Better documentation for using jitsu behind a proxy, Fix #121
pksunkara authored
138 ##jitsu behind proxy
139
140 If you are behind a proxy and you haven't configured jitsu to use it, `jitsu` will throw an error, `Jitsu requires you to connect to Nodejitsu's stack (api.nodejitsu.com)`.
141 In order to solve this issue, you can configure jitsu to use a proxy by executing the following command.
142
143 jitsu config set proxy http://proxy.domain.com:3128/
144
145 If you need to authenticate yourselves to the proxy, you can try this command.
146
147 jitsu config set proxy http://user:pass@proxy.domain.com:3128/
b87d33c @Marak [docs] Updating ReadMe
Marak authored
148
b4aa28e @Marak [misc] Added links to Libaries section
Marak authored
149 <a name="Libraries"></a>
b87d33c @Marak [docs] Updating ReadMe
Marak authored
150 ## Libraries
151 `jitsu` is built on a few well developed, well maintained Node.js libraries. The [Nodejitsu](http://nodejitsu.com) team and friends have been building and using these projects actively for the past two years. They are the most used Node libraries (see: [http://search.npmjs.org/](http://search.npmjs.org/)) and are actively maintained by Nodejitsu and other core members of the Node.js community. Each library serves a specific function and we highly suggest you check each one out individually if you wish to increase your knowledge of Node.js
b4aa28e @Marak [misc] Added links to Libaries section
Marak authored
152
d4d8eae @Marak [ux] Updated deploy usage
Marak authored
153 - [npm](http://npmjs.org) - Node Package Manager
f1edb58 @dipen Corrected libraries links in README.md
dipen authored
154 - [colors](https://github.com/marak/colors.js) - Terminal Colors module
155 - [optimist](https://github.com/substack/node-optimist) - CLI Options Parsing
56d60ff @mmalecki [doc] Fix ALL the links!
mmalecki authored
156 - [request](https://github.com/mikeal/request) - http request module
f08a670 @Marak Updating ReadMe
Marak authored
157 - [async](https://github.com/caolan/async) - Asynchronous Iteration
158 - [vows](http://vowsjs.org) - Asynchronous BDD testing library
f1edb58 @dipen Corrected libraries links in README.md
dipen authored
159 - [winston](https://github.com/flatiron/winston) - Multi-transport logging library
f08a670 @Marak Updating ReadMe
Marak authored
160
5d9044f @Marak [misc] Added Aliases section in ReadMe
Marak authored
161 ### Need more?
56d60ff @mmalecki [doc] Fix ALL the links!
mmalecki authored
162 The documentation for `jitsu` and the [Nodejitsu](http://nodejitsu.com) APIs is open-source and a work in-progress. For more information checkout the [Nodejitsu Handbook](https://github.com/nodejitsu/handbook)
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. Some ...
Marak authored
163
0dc265e @nicoreed [docs] added docs for the signup and login commands
nicoreed authored
164 #### (C) Copyright 2010, [Nodejitsu](http://nodejitsu.com) Inc.
Something went wrong with that request. Please try again.