GithubHelp home page GithubHelp logo

docker-osx's Introduction

docker-osx

WARNING THIS PROJECT IS DEPRECATED

This project was started before official docker support on Mac OS X. You need to use now the offical way from Docker team: https://docs.docker.com/docker-for-mac/.

It's better, faster, stronger.

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

What is docker-osx

Docker on OS X in three steps:

  1. Install VirtualBox and Vagrant.

  2. Put the docker-osx script somewhere on your path:

with bpkg:

  bpkg install noplay/docker-osx

or curl:

    curl https://raw.githubusercontent.com/noplay/docker-osx/HEAD/docker-osx > /usr/local/bin/docker-osx
    chmod +x /usr/local/bin/docker-osx
  1. Run:

     docker-osx shell
     docker version
    

This script acts as both an installer and as Virtual machine manager. On first run, it installs an OS X binary of the Docker client and starts a virtual machine with the Docker daemon running. It then sets up the shell environment so the Docker client knows to talk to the Docker daemon on the virtual machine.

The virtual machine that Docker runs on is given the hostname localdocker. For example, if you run docker run -p 8000:8000 ..., then that will be available at localdocker:8000 from OS X.

Additional commands

docker-osx provide additional commands as shortcuts for controlling the Vagrant VM:

docker-osx start

Start the local Virtual Machine

docker-osx ssh

Open a console on the Vagrant virtual machine.

docker-osx destroy

Destroy the local Virtual Machine

docker-osx halt

Stop the Vagrant VM. You'll probably want to do this after you've finished working with Docker project to save RAM.

docker-osx shell

Start the virtual machine and open a shell with DOCKER_HOST environment variable configured.

Override defaults

The docker-osx script has several options that can be overridden by adding a new file $HOME/.docker-osx/defaults. When docker-osx starts the VM, it will source this file.

When modifying the defaults for docker-osx, currently, it is best to destroy any already-created VM and configure a new one with the changes.

An example defaults file follows:

# $HOME/.docker-osx/defaults
DOCKER_IP=192.168.228.10

DOCKER_BIN

The installed location of the docker client.

Default: /usr/local/bin/docker

DOCKER_IP

The IP that the docker host will be mapped to on your machine.

Default: 172.16.42.43

DOCKER_DOMAIN

The domain name added to /etc/hosts, pointing at the DOCKER_IP.

Default: localdocker

DOCKER_PORT

The port that docker will be listening on.

Default: 4243

DOCKER_VERSION

The version of docker that will be installed when provisioning the vagrant vm.

Default: 1.2.0

DOCKER_CLIENT_URL

The URL used to download the docker client.

Default: http://get.docker.io/builds/Darwin/x86_64/docker-${DOCKER_VERSION}.tgz

VAGRANT_BOX_URL

The URL used to download the vagrant box.

Default: https://bfirsh.s3.amazonaws.com/docker/vagrant/vagrant-docker-0.8.0-virtualbox.box

Contributors

Licence

Copyright 2013 Julien Duponchelle

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

docker-osx's People

Contributors

bfirsh avatar julien-duponchelle avatar beorn avatar mmerickel avatar aanand avatar cschneid avatar felixrabe avatar tudborg avatar jwerle avatar mauvm avatar annapowellsmith avatar eriksaunier avatar fayimora avatar germandz avatar lazyatom avatar mboersma avatar michaelneale avatar mikerogers0 avatar stefanfoulis avatar wmatyskiewicz avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.