| 
									
										
										
										
											2019-10-31 00:35:17 -06:00
										 |  |  | # [greenlock-manager-fs.js](https://git.rootprojects.org/root/greenlock-manager-fs.js)
 | 
					
						
							| 
									
										
										
										
											2019-10-21 21:47:37 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-10-31 00:35:17 -06:00
										 |  |  | A simple file-based management strategy for Greenlock v3 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | (to manage SSL certificates for sites) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Install
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | npm install --save greenlock-manager-fs@v3 | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Use with Greenlock
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | var greenlock = require('greenlock').create({ | 
					
						
							|  |  |  | 	// ... | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	manager: 'greenlock-manager-fs', | 
					
						
							|  |  |  | 	configFile: '~/.config/greenlock/manager.json' | 
					
						
							|  |  |  | }); | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Example config file
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | You might start your config file like this: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | `~/.config/greenlock/manager.json`: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```json | 
					
						
							|  |  |  | { | 
					
						
							|  |  |  | 	"subscriberEmail": "jon@example.com", | 
					
						
							|  |  |  | 	"agreeToTerms": true, | 
					
						
							|  |  |  | 	"sites": [ | 
					
						
							|  |  |  | 		{ | 
					
						
							|  |  |  | 			"subject": "example.com", | 
					
						
							|  |  |  | 			"altnames": ["example.com", "*.example.com"] | 
					
						
							|  |  |  | 		} | 
					
						
							|  |  |  | 	] | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## CLI Management (coming soon)
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | We're going to be adding some tools to greenlock so that you can do | 
					
						
							|  |  |  | something like this to manage your sites and SSL certificates: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | npx greenlock defaults --subscriber-email jon@example.com --agree-to-terms true | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | npx greenlock add --subject example.com --altnames example.com,*.example.com | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | npx greenlock renew --all | 
					
						
							|  |  |  | ``` |