Repository files navigation

The ultimate private bower server.

Twitter:@private_bower,#private_bower

• Features
• Features to come
• Installation
• Parameters
• Config file
• Usage
  • Web interface
  • Project
  • List packages
  • Search packages
  • Register package
  • Register packages
  • Remove package
  • Remove packages
  • Restart server
  • Refresh caches
  • Authentication
  • Log4js configuration examples
• License
• Tips for usage
• Contributing

• Register private packages
• Fallback to public packages
• Cache public registry
• Cache public git repositories
• Cache public svn repositories
• Web UI with package details
• Web UI package management
• Blacklist public packages
• Whitelist public packages

Install

npm install -g private-bower

Run

private-bower

Run with config file specified

private-bower --config ./myBowerConfig.json

If there's no private package with requested package name the servers calls through to the public bower registry.

Must be a valid JSON

{"registryFile":"./bowerRepository.json","timeout":144000,"server":{"port":5678,"hostName":null,"siteBaseUrl":null},"public":{"disabled":false,"registry":"http://bower.herokuapp.com/packages","registryFile":"./bowerRepositoryPublic.json","whitelist":[],"blacklist":[]},"authentication":{"enabled":false,"key":"password"},"repositoryCache":{"cachePrivate":false,"git":{"enabled":false,"cacheDirectory":"./gitRepoCache","host":"localhost","port":6789,"protocol":"git","publicAccessURL":null,"refreshTimeout":10,"refreshDisabled":false},"svn":{"enabled":false,"cacheDirectory":"./svnRepoCache","host":"localhost","port":7891,"protocol":"svn","publicAccessURL":null,"refreshTimeout":10,"refreshDisabled":false}},"proxySettings" :{"enabled":false,"host":"proxy","username":"name","password":"pass","port":8080,"tunnel":false},"log4js" :{"enabled":false,"configPath":"log4js.conf.json"}}

Convenient way for viewing your packages in a browser. The web interface will only list your private packages, it willnot list the public packages if you have a public registry enabled. However, when searching for packages in bower, thepublic ones will show up just fine.

http://localhost:5678/

Within your project, you will need to create a .bowerrc file containing the URL of your private bower server:

{"registry":"http://yourPrivateBowerRepo:5678","timeout":300000}

If you are using private bower withserver.siteBaseURL option, you need to add the same path the registry url in your .bowerrc file:

Config

{"server": {"port":6789,"hostName":"yourPrivateBowerRepo","setBaseURL":"/my-private-bower"  }}

.bowerrc

{"registry":"http://yourPrivateBowerRepo:6789/my-private-bower","timeout":300000}

GET

bower-server:5678/packages

bower search [packageName]

bower register [packageName] [gitRepo]

orPOST

bower-server:5678/packages

{ "name": "package-name", "url": "git://repoPath" }

orPOST

bower-server:5678/packages/<package name>

{ "url": "git://repoPath" }

POST

bower-server:5678/packages

[ { "name": "package-name", "url": "git://repoPath" } ]

DELETE

bower-server:5678/packages/<package name>

DELETE

bower-server:5678/packages

["package-name"]

POST

bower-server:5678/restart

POST

bower-server:5678/refresh

Authentication can be enabled for the following features:

• Register package
• Register packages
• Remove package
• Remove packages
• Restart server

AddAuth-Key header to request.

Auth-Key = password

There are two appenders set in the example configuration.You need to remove one of the two if you want to use it.fileDate appender will write the log to a file which will be rotated daily.Console will write the logging to the console in the log4js format.You need to set the replaceConsole to true if you want to write the logging to the log4j appenders.See github.com/nomiddlename/log4js-node for more information

• Installing on Ubuntu
• Install as a Windows service

git config --global url."https://".insteadOf git://

• do not forget to set theContent-Type header toapplication/json

Please read the rules of contributing on thecontribution page.

The MIT License (MIT)

Copyright (c) 2014 Hacklonehttps://github.com/Hacklone

Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.