reflow to 80 chars and fix image links

Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>
This commit is contained in:
Sven Dowideit 2015-05-13 02:57:00 +00:00
Родитель aef4c6b11c
Коммит 144b0c3c6f
9 изменённых файлов: 201 добавлений и 100 удалений

Просмотреть файл

@ -5,43 +5,56 @@ page_keywords: docker, documentation, about, technology, kitematic, gui
# Frequently Asked Questions
### Is Kitematic Open Source?
Yes! Our source code is available on [GitHub](https://github.com/kitematic/kitematic). Kitematic is open source software released under the Apache 2.0 license.
Yes! Our source code is available on
[GitHub](https://github.com/kitematic/kitematic). Kitematic is open source
software released under the Apache 2.0 license.
### How can I contribute to Kitematic?
We always welcome (and deeply appreciate!) new contributions to the project. The best way to start contributing to Kitematic is to review our doc on [contributing](https://github.com/kitematic/kitematic/blob/master/CONTRIBUTING.md).
We always welcome (and deeply appreciate!) new contributions to the project. The
best way to start contributing to Kitematic is to review our doc on
[contributing](https://github.com/kitematic/kitematic/blob/master/CONTRIBUTING.md).
### How does Kitematic work with Docker?
Kitematic connects directly do a running instance of Docker and controls it via the Docker Remote API.
Kitematic connects directly do a running instance of Docker and controls it via
the Docker Remote API.
### Which platforms does Kitematic support?
Right now Kitematic only works on Mac OS X. That said, Windows is on the short-term [roadmap](https://github.com/kitematic/kitematic/blob/master/ROADMAP.md) (coming soon!) and a Linux version is in high demand.
Right now Kitematic only works on Mac OS X. That said, Windows is on the
short-term
[roadmap](https://github.com/kitematic/kitematic/blob/master/ROADMAP.md) (coming
soon!) and a Linux version is in high demand.
### Why does Kitematic collect usage analytics and bug reports?
Kitematic tracks anonymous errors and analytics to help understand why things go wrong and to help understand how users are interacting with the app so we can continuously make it better.
Kitematic tracks anonymous errors and analytics to help understand why things go
wrong and to help understand how users are interacting with the app so we can
continuously make it better.
You can opt-out of this anytime via the in-app preferences.
#### What we DON'T collect
- Personal information: any information that would allow us to determine a specific user of Kitematic
- Information or data relating to code, containers or Docker images opened via Kitematic.
- Personal information: any information that would allow us to determine a
specific user of Kitematic
- Information or data relating to code, containers or Docker images opened via
Kitematic.
#### What we DO collect
- Anonymous events for actions in the app. We never collect data associated with events. For example:
- Anonymous events for actions in the app. We never collect data associated with
events. For example:
- User searched for images (but not what the search query was).
- User created a container (but not which image, the name of the container or any data involved)
- User created a container (but not which image, the name of the container or
any data involved)
- User opened the preferences pane
- User deleted a container
- Errors names, messages & stack traces (scrubbed for user names)
- Operating System, Kitematic and installed VirtualBox versions
We'd love to answer any more questions about this. Feel free to reach us at kitematic@docker.com or to open an issue on GitHub.
We'd love to answer any more questions about this. Feel free to reach us at
kitematic@docker.com or to open an issue on GitHub.

Просмотреть файл

@ -6,38 +6,60 @@ page_keywords: docker, documentation, about, technology, kitematic, gui
## Overview
Kitematic is an open source project built to simplify and streamline using Docker on a Mac or Windows (coming soon) PC. Kitematic automates the Docker installation and setup process and provides an intuitive graphical user interface (GUI) for running Docker containers. Kitematic integrates with [Docker Machine](http://docs.docker.com/machine/) to provision a VirtualBox VM and install the Docker Engine locally on your machine.
Once installed, the Kitematic GUI launches and from the home screen you will be presented with curated images that you can run instantly. You can search for any public images on Docker Hub from Kitematic just by typing in the search bar. You can use the GUI to create, run and manage your containers just by clicking on buttons. Kitematic allows you to switch back and forth between the Docker CLI and the GUI. Kitematic also automates advanced features such as managing ports and configuring volumes. You can use Kitematic to change environment variables, stream logs, and single click terminal into your Docker container all from the GUI.
Kitematic is an open source project built to simplify and streamline using
Docker on a Mac or Windows (coming soon) PC. Kitematic automates the Docker
installation and setup process and provides an intuitive graphical user
interface (GUI) for running Docker containers. Kitematic integrates with
[Docker Machine](http://docs.docker.com/machine/) to provision a VirtualBox VM
and install the Docker Engine locally on your machine.
Once installed, the Kitematic GUI launches and from the home screen you will be
presented with curated images that you can run instantly. You can search for any
public images on Docker Hub from Kitematic just by typing in the search bar.
You can use the GUI to create, run and manage your containers just by clicking
on buttons. Kitematic allows you to switch back and forth between the Docker CLI
and the GUI. Kitematic also automates advanced features such as managing ports
and configuring volumes. You can use Kitematic to change environment variables,
stream logs, and single click terminal into your Docker container all from the
GUI.
## Installing Kitematic
You install Kitematic much the same way you install any application on a Mac or Windows PC: download an image and run an installer.
You install Kitematic much the same way you install any application on a Mac or
Windows PC: download an image and run an installer.
### Download Kitematic
[Download the Kitematic zip file](/download), unzip the file by double-clicking it, and then double-click the application to run it. You'll probably also want to put the application in your Applications folder.
[Download the Kitematic zip file](https://kitematic.com/download/), unzip the
file by double-clicking it, and then double-click the application to run it.
You'll probably also want to put the application in your Applications folder.
### Initial Setup
Opening Kitematic for the first time sets up everything you need to run Docker containers. If you don't already have VirtualBox installed, Kitematic will download and install the latest version.
Opening Kitematic for the first time sets up everything you need to run Docker
containers. If you don't already have VirtualBox installed, Kitematic will
download and install the latest version.
![Installing](assets/installing.png)
![Installing](./assets/installing.png)
All Done! Within a minute you should be ready to start running your first container!
All Done! Within a minute you should be ready to start running your first
container!
![containers](assets/containers.png)
![containers](./assets/containers.png)
### Technical Details
Kitematic is a self-contained .app, with a two exceptions:
- It will install VirtualBox if it's not already installed.
- It copies the `docker` and `docker-machine` binaries to `/usr/local/bin` for convenience.
- It copies the `docker` and `docker-machine` binaries to `/usr/local/bin` for
convenience.
#### Why does Kitematic need my root password?
Kitematic needs your root password for two reasons:
- Installing VirtualBox requires root as it includes Mac OS X kernel extensions.
- Copying `docker` and `docker-machine` to `/usr/local/bin` may require root permission if the default permissions for this directory have been changed prior to installing Kitematic.
- Copying `docker` and `docker-machine` to `/usr/local/bin` may require root
permission if the default permissions for this directory have been changed
prior to installing Kitematic.

Просмотреть файл

@ -5,25 +5,40 @@ page_keywords: docker, documentation, about, technology, kitematic, gui
# Known Issues
Kitematic is in beta, so we're still working out the kinks. The most common errors occur at the setup stage since creating a VM reliably with VirtualBox can be tricky. We are working on this problem.
Kitematic is in beta, so we're still working out the kinks. The most common
errors occur at the setup stage since creating a VM reliably with VirtualBox can
be tricky. We are working on this problem.
In the meantime, below are a list of common errors and solutions that work for most people.
In the meantime, below are a list of common errors and solutions that work for
most people.
## Setup Error or Hanging at 99%
Sometimes Kitematic doesn't set up VirtualBox properly. Retrying the setup usually works (via one of the two retry buttons). If not, try the following commands on the command line:
Sometimes Kitematic doesn't set up VirtualBox properly. Retrying the setup
usually works (via one of the two retry buttons). If not, try the following
commands on the command line:
- `docker-machine rm -f dev`
- `docker-machine create -d virtualbox dev`
Then re-open Kitematic. This usually fixes the issue, but if it persists, feel free to view our [existing GitHub issues](https://github.com/kitematic/kitematic/issues?q=is%3Aopen+is%3Aissue+label%3Abug).
Then re-open Kitematic. This usually fixes the issue, but if it persists, feel
free to view our [existing GitHub
issues](https://github.com/kitematic/kitematic/issues?q=is%3Aopen+is%3Aissue+label%3Abug).
## Contributing Fixes
We're always looking for help to make Kitematic better and more reliable! Visit [our GitHub page](https://github.com/kitematic/kitematic) for docs on how to contribute.
We're always looking for help to make Kitematic better and more reliable! Visit
[our GitHub page](https://github.com/kitematic/kitematic) for docs on how to
contribute.
Under the hood, Kitematic uses [Docker Machine](https://github.com/docker/machine) to provision Docker-enabled VMs via VirtualBox. We're still working on a stronger integration with this project. Their [GitHub repo](https://github.com/docker/machine) is a great place to start if you're looking to help fix specific issues around VM provisioning.
Under the hood, Kitematic uses [Docker
Machine](https://github.com/docker/machine) to provision Docker-enabled VMs via
VirtualBox. We're still working on a stronger integration with this project.
Their [GitHub repo](https://github.com/docker/machine) is a great place to start
if you're looking to help fix specific issues around VM provisioning.
## View All Issues
For a full list of Kitematic bugs or issues see our [GitHub issues](https://github.com/kitematic/kitematic/issues?q=is%3Aopen+is%3Aissue+label%3Abug) labelled as `bug`.
For a full list of Kitematic bugs or issues see our [GitHub
issues](https://github.com/kitematic/kitematic/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
labelled as `bug`.

Просмотреть файл

@ -2,18 +2,24 @@ page_title: Managing Volumes with Kitematic
page_description: Documentation explaining how Kitematic manages container volumes
page_keywords: docker, documentation, about, technology, kitematic, gui, volumes
# Managing Volumes
### Default Volume Directories
Every container created through Kitematic automatically has its volumes exposed on your Mac, which means you can manage files in volumes via the Finder. Kitematic exposes a container's volume data under `~/Kitematic/<container's name>/`. Quick access to this folder (or directory) is available via the app:
Every container created through Kitematic automatically has its volumes exposed
on your Mac, which means you can manage files in volumes via the Finder.
Kitematic exposes a container's volume data under `~/Kitematic/<container's name>/`.
Quick access to this folder (or directory) is available via the app:
![Accessing the volumes directory](assets/volumes-dir.png)
![Accessing the volumes directory](../assets/volumes-dir.png)
### Changing Volume Directories
Let's say you have an Nginx webserver running via Kitematic (using the `kitematic/hello-world-nginx` image on DockerHub). However, you don't want to use the default directory created for the website_files volume. Instead, you already have the HTML, Javascript, and CSS for your website under `~/workspace/website`. Kitematic makes it easy to change the container's volume to read from this directory instead of the default one created by Kitematic:
Let's say you have an Nginx webserver running via Kitematic (using the
`kitematic/hello-world-nginx` image on DockerHub). However, you don't want to
use the default directory created for the website_files volume. Instead, you
already have the HTML, Javascript, and CSS for your website under
`~/workspace/website`. Kitematic makes it easy to change the container's volume
to read from this directory instead of the default one created by Kitematic:
![screen shot 2015-02-28 at 2 48 01 pm](assets/change-folder.png)
![screen shot 2015-02-28 at 2 48 01 pm](../assets/change-folder.png)

Просмотреть файл

@ -4,49 +4,59 @@ page_keywords: docker, documentation, about, technology, kitematic, gui, minecra
# Kitematic tutorial: Set up a Minecraft server
This is a quick tutorial demonstrating how to set up a local Minecraft server using Kitematic and Docker.
This is a quick tutorial demonstrating how to set up a local Minecraft server
using Kitematic and Docker.
### Create Minecraft Server Container
Create a container from the recommended Minecraft image by clicking the "Create" button.
Create a container from the recommended Minecraft image by clicking the "Create"
button.
![create Minecraft container](assets/minecrafte-create.png)
![create Minecraft container](../assets/minecraft-create.png)
After the image finishes downloading, youll see the home screen for the Minecraft container. Your Minecraft server is now up and running inside a Docker container. Note that weve marked the IP and port you can use to connect to your Minecraft server in red (your IP and port may be different from what's shown).
After the image finishes downloading, you'll see the home screen for the
Minecraft container. Your Minecraft server is now up and running inside a Docker
container. Note that we've marked the IP and port you can use to connect to
your Minecraft server in red (your IP and port may be different from what's
shown).
![Minecraft server port and IP info](assets/minecraft-port.png)
![Minecraft server port and IP info](../assets/minecraft-port.png)
### Connect to Minecraft server
Open your Minecraft client, log in with your Minecraft account and click on the "Multiplayer" button.
Open your Minecraft client, log in with your Minecraft account and click on the
"Multiplayer" button.
![Minecraft login screen](assets/minecraft-login.png)
![Minecraft login screen](../assets/minecraft-login.png)
Click the "Add Server" button to add the Minecraft server you want to connect to.
Click the "Add Server" button to add the Minecraft server you want to connect
to.
![Add server]assets/minecraft-login.png)
![Add server](../assets/minecraft-login.png)
Fill in the "Server Address" text box with the marked IP and port from Kitematic you saw earlier.
Fill in the "Server Address" text box with the marked IP and port from Kitematic
you saw earlier.
![Minecraft server address](assets/minecraft-server-address.png)
![Minecraft server address](../assets/minecraft-server-address.png)
Click on the play button to connect to your Minecraft server and enjoy!
### Change map using Docker volume
Open the "data" folder from Kitematic. We use Docker Volume to map the folder from the Minecraft Docker container onto your computer.
Open the "data" folder from Kitematic. We use Docker Volume to map the folder
from the Minecraft Docker container onto your computer.
![Minecraft data volume](assets/minecraft-data-volume.png)
![Minecraft data volume](../assets/minecraft-data-volume.png)
The Finder will open, allowing you to replace your current map with the new one you desire.
The Finder will open, allowing you to replace your current map with the new one
you desire.
![Minecraft maps](assets/minecraft-map.png)
![Minecraft maps](../assets/minecraft-map.png)
Restart your container by clicking the "Restart" button.
![Restart Minecraft container](assets/minecraft-restart.png)
![Restart Minecraft container](../assets/minecraft-restart.png)
Go back to your Minecraft client and join your server. The new map should load.

Просмотреть файл

@ -6,7 +6,7 @@
- ['kitematic/minecraft-server.md', 'Examples', 'Kitematic: Minecraft server']
- ['kitematic/nginx-web-server.md', 'Examples', 'Kitematic: Ngnix web server']
- ['kitematic/rethinkdb-dev-database.md', 'Examples', 'Kitematic: Rethingdb development database']
- ['kitematic/rethinkdb-dev-database.md', 'Examples', 'Kitematic: RethinkDB development database']
- ['kitematic/faq.md', 'Reference', 'Kitematic: FAQ']
- ['kitematic/known-issues.md', 'Reference', 'Kitematic: Known issues']

Просмотреть файл

@ -10,45 +10,66 @@ In this tutorial, you will:
- Explore the container's website data natively on your Mac
- Use volumes to modify the website data
In this example website we'll be serving the popular 2048 game, as shown below. Let's get to it!
In this example website we'll be serving the popular 2048 game, as shown below.
Let's get to it!
![2048 game](assets/nginx-2048.png)
![2048 game](../assets/nginx-2048.png)
#### Running the Nginx Web Server Container
First, if you haven't yet done so, [download and start Kitematic](https://kitematic.com/download) . Once installed and running, the app should look like this:
First, if you haven't yet done so, [download and start
Kitematic](https://kitematic.com/download) . Once installed and running, the app
should look like this:
![Nginx create](assets/nginx-create.png)
![Nginx create](../assets/nginx-create.png)
Click on the _Create_ button of the `hello-world-nginx` listing as shown above. This will download and run a tiny Nginx web server in a container via Kitematic, allowing you to serve website data on your Mac.
Click on the _Create_ button of the `hello-world-nginx` listing as shown above.
This will download and run a tiny Nginx web server in a container via Kitematic,
allowing you to serve website data on your Mac.
![download Nginx hello world](assets/nginx-hello-world.png)
![download Nginx hello world](../assets/nginx-hello-world.png)
Once it's done downloading you should see a quick preview of the example website that comes with the container, as shown below. Click on the preview to see the result in your own browser.
Once it's done downloading you should see a quick preview of the example website
that comes with the container, as shown below. Click on the preview to see the
result in your own browser.
![Nginx preview](assets/nginx-preview.png)
![Nginx preview](../assets/nginx-preview.png)
**What just happened?** Kitematic downloaded the `kitematic/hello-world-nginx` image from the Docker Hub and then created and ran a Docker Nginx container from this image.
**What just happened?** Kitematic downloaded the `kitematic/hello-world-nginx`
image from the Docker Hub and then created and ran a Docker Nginx container from
this image.
#### Viewing the Website Data in Finder
This container exposes website data via a _Docker volume_. Kitematic makes managing Docker volumes easy - you can edit the data in Finder or with your favorite text editor. By default, Kitematic places volumes under `~/Kitematic` but you can change this in the container settings. To access the files via finder, click on the in-app folder icon for a container:
This container exposes website data via a _Docker volume_. Kitematic makes
managing Docker volumes easy - you can edit the data in Finder or with your
favorite text editor. By default, Kitematic places volumes under `~/Kitematic`
but you can change this in the container settings. To access the files via
finder, click on the in-app folder icon for a container:
![Nginx data volume](assets/nginx-data-volume.png)
![Nginx data volume](../assets/nginx-data-volume.png)
A Finder window of the folder should open containing the index.html file we see being served by the container.
A Finder window of the folder should open containing the index.html file we see
being served by the container.
![Nginx data folder](assets/nginx-data-folder.png)
![Nginx data folder](../assets/nginx-data-folder.png)
#### Serving Your Own Website Data
Now let's try serving a more interesting website. [Download the zipped files](https://github.com/gabrielecirulli/2048/archive/master.zip) for 2048, a popular (and addictive) web-based tile game. Extract this zip file into the folder you just opened:
Now let's try serving a more interesting website. [Download the zipped
files](https://github.com/gabrielecirulli/2048/archive/master.zip) for 2048, a
popular (and addictive) web-based tile game. Extract this zip file into the
folder you just opened:
![Website files for 2048](assets/nginx-2048-files.png)
![Website files for 2048](../assets/nginx-2048-files.png)
Switch back to Kitematic and restart the container by clicking the "Restart" button as shown below. Your Nginx container should now be serving 2048.
Switch back to Kitematic and restart the container by clicking the "Restart"
button as shown below. Your Nginx container should now be serving 2048.
![Nginx running 2048](assets/nginx-serving-2048.png)
![Nginx running 2048](../assets/nginx-serving-2048.png)
**What just happened?**
Kitematic automatically reveals Docker container volumes via directories on your Mac. In this case you changed the container's volume data via the Finder to serve a website we downloaded.
Kitematic automatically reveals Docker container volumes via directories on your
Mac. In this case you changed the container's volume data via the Finder to
serve a website we downloaded.

Просмотреть файл

@ -2,11 +2,8 @@ page_title: Kitematic Tutorial: Set up an Nginx web server
page_description: Tutorial demonstrating the setup of an Nginx web server using Docker and Kitematic
page_keywords: docker, documentation, about, technology, kitematic, gui, rethink, tutorial
# Creating a Local RethinkDB Database for Development
---
In this tutorial, you will:
- Create a RethinkDB Container for Development
@ -14,34 +11,47 @@ In this tutorial, you will:
### Setting up RethinkDB in Kitematic
First, if you haven't yet done so, [download and start Kitematic](https://kitematic.com/download). Once open, the app should look like this:
First, if you haven't yet done so, [download and start
Kitematic](https://kitematic.com/download). Once open, the app should look like
this:
![Rethink create button](assets/rethink-create.png)
![Rethink create button](../assets/rethink-create.png)
Click on the _Create_ button of the `rethinkdb` image listing in the recommended list as shown above. This will download & run a RethinkDB container within a few minutes. Once it's done, you'll have a local RethinkDB database up and running.
Click on the _Create_ button of the `rethinkdb` image listing in the recommended
list as shown above. This will download & run a RethinkDB container within a few
minutes. Once it's done, you'll have a local RethinkDB database up and running.
![Rethink container](assets/rethink-container.png)
![Rethink container](../assets/rethink-container.png)
Let's start using it to develop a node.js app. For now, let's figure out which IP address and port RethinkDB is listening on. To find out, click the `Settings` tab and then the `Ports` section:
Let's start using it to develop a node.js app. For now, let's figure out which
IP address and port RethinkDB is listening on. To find out, click the `Settings`
tab and then the `Ports` section:
![Rethink create button](assets/rethink-create.png)
![Rethink create button](../assets/rethink-create.png)
You can see there that for RethinkDB port `28015`, the container is listening on host `192.168.99.100` and port `49154` (in this example - ports may be different for you). This means you can now reach RethinkDB via a client driver at `192.168.99.100:49154`. Again, this IP address may be different for you.
You can see there that for RethinkDB port `28015`, the container is listening on
host `192.168.99.100` and port `49154` (in this example - ports may be different
for you). This means you can now reach RethinkDB via a client driver at
`192.168.99.100:49154`. Again, this IP address may be different for you.
### (Advanced) Saving Data into RethinkDB with a local Node.js App
First, if you don't have it yet, [download and install Node.js](http://nodejs.org/).
First, if you don't have it yet, [download and install
Node.js](http://nodejs.org/).
Now, you'll create the RethinkDB example chat to test drive your new database. In your terminal, type:
Now, you'll create the RethinkDB example chat to test drive your new database.
In your terminal, type:
bash-3.2$ export RDB_HOST=192.168.99.100 # replace with IP from above step
bash-3.2$ export RDB_PORT=49154 # replace with Port from above step
bash-3.2$ git clone https://github.com/rethinkdb/rethinkdb-example-nodejs-chat
bash-3.2$ cd rethinkdb-example-nodejs-chat
bash-3.2$ npm install
bash-3.2$ npm start
$ export RDB_HOST=192.168.99.100 # replace with IP from above step
$ export RDB_PORT=49154 # replace with Port from above step
$ git clone https://github.com/rethinkdb/rethinkdb-example-nodejs-chat
$ cd rethinkdb-example-nodejs-chat
$ npm install
$ npm start
Now, point your browser to `http://localhost:8000`. Congratulations, you've successfully used a RethinkDB container in Kitematic to build a real-time chat app. Happy coding!
Now, point your browser to `http://localhost:8000`. Congratulations, you've
successfully used a RethinkDB container in Kitematic to build a real-time chat
app. Happy coding!
![Rethink app preview](assets/rethink-preview.png)
![Rethink app preview](../assets/rethinkdb-preview.png)

Просмотреть файл

@ -1,25 +1,29 @@
page_title: Accessing the Docker CLI in Kitematic
page_description: Documentation describing how to work on the Docker command line using Kitematic
page_keywords: docker, documentation, about, technology, kitematic, gui, cli,
page_keywords: docker, documentation, about, technology, kitematic, gui, cli,
# Docker Command-line Access
You can interact with existing containers in Kitematic or create new containers via the Docker Command Line Interface (CLI). Any changes you make on the CLI are directly reflected in Kitematic.
You can interact with existing containers in Kitematic or create new containers
via the Docker Command Line Interface (CLI). Any changes you make on the CLI are
directly reflected in Kitematic.
### Opening a Terminal for the Docker CLI
To open a terminal via Kitematic, just press whale button at the bottom left, as shown below:
To open a terminal via Kitematic, just press whale button at the bottom left, as
shown below:
![CLI access button](cli-access-button.png)
![CLI access button](../assets/cli-access-button.png)
### Example: Creating a new Redis container
Start by opening a Docker-CLI ready terminal by clicking the whale button as described above. Once the terminal opens, enter `docker run -d -P redis`. This will pull and run a new Redis container via the Docker CLI.
Start by opening a Docker-CLI ready terminal by clicking the whale button as
described above. Once the terminal opens, enter `docker run -d -P redis`. This
will pull and run a new Redis container via the Docker CLI.
![Docker CLI terminal window](cli-terminal.png)
![Docker CLI terminal window](../assets/cli-terminal.png)
Now, go back to Kitematic. The Redis container should now be visible.
![Redis container in Kitematic](cli-redis-container.png)
![Redis container in Kitematic](../assets/cli-redis-container.png)