Source repo for Docker's Documentation
Go to file
Jeff Morgan 4fb57eb4c1 Fixing breaking bug if old version of virtualbox is installed. 2014-09-12 02:12:20 -07:00
meteor Fixing breaking bug if old version of virtualbox is installed. 2014-09-12 02:12:20 -07:00
resources fixing route daemon 2014-09-10 21:51:42 -07:00
script Adding CFBundleName for script 2014-09-11 15:45:54 -07:00
.gitignore Specific verison of boot2docker 2014-09-10 23:17:19 -07:00
CONTRIBUTING.md Updated Trello board link. 2014-09-02 13:24:08 -07:00
LICENSE Initial commit 2014-08-27 13:45:22 -07:00
README.md Update README.md 2014-09-04 00:27:50 -07:00
index.js Fixing breaking bug if old version of virtualbox is installed. 2014-09-12 02:12:20 -07:00
kitematic.icns Adding setup page for usage diagnostics 2014-09-10 19:39:25 -07:00
package.json Fixing breaking bug if old version of virtualbox is installed. 2014-09-12 02:12:20 -07:00

README.md

Kitematic

Note: If the installer gets stuck at any step for more than 1 minute, there is probably an error. Please help us troubleshoot by running it from the command line, and submit the logs to contact@kitematic.com.

  1. cd <dir with Kitematic.app>
  2. Run ./Kitematic.app/Contents/MacOS/node-webkit

Kitematic is still in Beta. Any effort in helping us find issues and improving the experience is greatly appreciated!

Fixes for Known Issues

Kitematic Screenshot

Table of Contents

Development

  • Install any version of Node.js
  • Install meteor.js curl https://install.meteor.com/ | sh.
  • Install meteorite npm install meteorite -g
  • Install demeteorizer npm install demeteorizer -g
  • Run ./script/setup.sh to download the binary requirements (things like virtualbox).

Running the development Server

  • ./script/run.sh

Building the Mac OS X Package

  • ./script/bundle.sh # Generates the app bundle under ./bundle
  • ./script/dist.sh # Generates the app under ./dist./osx/Kitematic.app

Uninstalling

(This will improve over time.)

  • Remove VirtualBox
  • sudo route delete -net 172.17.0.0 -netmask 255.255.0.0 -gateway 192.168.60.103 (disable routing to containers through VM)
  • rm -rf ~/Library/Application\ Support/Kitematic (remove app data)
  • rm /Library/LaunchAgents/com.kitematic.route.plist (remove launch job that sets up routing to the containers)

Bugs and Feature Requests

Have a bug or a feature request? Please first read the Issue Guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Documentation

Kitematic's documentation and other information can be found at http://kitematic.com/docs.

Contributing

Please read through our Contributing Guidelines. Included are directions for opening issues, coding standards, and notes on development.

Development Roadmap can be found on our Trello board.

Community

Keep track of development and community news.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Kitematic is maintained under the Semantic Versioning Guidelines. We'll try very hard to adhere to those rules whenever possible.

Creators

Team E-mail: contact@kitematic.com

Sean Li

Jeffrey Morgan

Michael Chiang

Code released under the AGPL license.