aliten / kitematic

Simple Docker App management for Mac OS X.

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 [e-mail].

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

Table of Contents

• Development
• Bugs and Feature Requests
• Documentation
• Contributing
• Community
• Versioning
• Creators
• Copyright and License

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
• rm /usr/local/bin/boot2docker
• sudo route delete 172.17.0.0/16 192.168.59.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.

• Follow @kitematic on Twitter.
• Check out Kitematic's Roadmap on our Trello board.
• Read and subscribe to The Official Kitematic Blog.
• Chat with developers using Kitematic in our HipChat room.

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 adhere to those rules whenever possible.

Creators

Team E-mail: [e-mail]

Sean Li

• https://twitter.com/lisean106
• https://github.com/Elesant
• Email: [e-mail]
• LinkedIn

Jeffrey Morgan

• https://twitter.com/jmorgan
• https://github.com/jeffdm
• Email: [e-mail]
• LinkedIn

Michael Chiang

• https://twitter.com/mchiang0610
• https://github.com/mk101
• Email: [e-mail]
• LinkedIn

Copyright and License

Code released under the AGPL license.