<commit_before>---
title: SDC Docker Operators Guide
markdown2extras: tables, code-friendly, cuddled-lists, link-patterns
markdown2linkpatternsfile: link-patterns.txt
---

# SDC Docker Operations

Welcome to Docker on SmarDataCenter. The Docker Engine for SDC is currently in
alpha and under heavy development. The current focus is stabilization and
filling out support for *running* Docker containers.

SDC Docker is a Docker Engine for SmartDataCenter (SDC) where the entire DC is
exposed as a single Docker host. The SDC Docker engine runs as the 'docker' SMF
service in a 'docker' core SDC zone.

This document includes details on operating an SDC Docker image. If you are interested in developing
the Docker Engine for SDC, see the [sdc-docker README](https://github.com/joyent/sdc-docker/blob/master/README.md).

The Docker Engine for SmartDataCenter treats the entire data center as
a single Docker host. Each container is a SmartOS LX-branded zone. Benefits:

- [Zones](http://en.wikipedia.org/wiki/Solaris_Containers) have a
  proven security track record for isolation.
- LX-branded zones provide the abilty to run Linux binaries in SmartOS
  zones, meaning you can use Docker images without modification *and*
  without the overhead of hardware-based virtualization.
- [Overlay network](http://en.wikipedia.org/wiki/Overlay_network)
  support (VXLAN) means you have a private network between all your containers,
  across servers.

And the full stack is open source: [sdc-docker](https://github.com/joyent/sdc-docker),
[SmartDataCenter](https://github.com/joyent/sdc),
and [SmartOS](https://github.com/joyent/smartos-live).

**A note for users of Joyent's public cloud:** Joyent is hosting a beta of
their Docker service. Please sign up at https://www.joyent.com/lp/preview and
read on for the settings for the standard Docker client.


## Current Status

The Docker Engine for SDC is currently in alpha and under heavy development.
The current focus is on stabilization and filling out support for *building* and
*running* Docker containers.
Please [report issues](https://github.com/joyent/sdc-docker/issues),
give us feedback or discuss on [#joyent IRC on freenode.net](irc://freenode.net/#joyent).

### 3. sdc-docker-setup.sh

Now that you have access to a SmartDataCenter, we will set up authentication
to the Docker host. SDC Docker uses Docker's TLS authentication. This section
will show you how to create a TLS client certificate from the SSH key you
created in the previous section. Then we'll configure `docker` to send that
client certificate to identify requests as coming from you.

Follow the steps in [the API guide to get connected and start using SDC Docker](../api/README.md).


## Package Selection

If the docker client specifies either -m (memory) or -c (cpu\_shares), we'll look<commit_msg>TRITON-2231 Update documented IRC channel (#162)<commit_after>---
title: SDC Docker Operators Guide
markdown2extras: tables, code-friendly, cuddled-lists, link-patterns
markdown2linkpatternsfile: link-patterns.txt
---

# SDC Docker Operations

Welcome to Docker on SmarDataCenter. The Docker Engine for SDC is currently in
alpha and under heavy development. The current focus is stabilization and
filling out support for *running* Docker containers.

SDC Docker is a Docker Engine for SmartDataCenter (SDC) where the entire DC is
exposed as a single Docker host. The SDC Docker engine runs as the 'docker' SMF
service in a 'docker' core SDC zone.

This document includes details on operating an SDC Docker image. If you are interested in developing
the Docker Engine for SDC, see the [sdc-docker README](https://github.com/joyent/sdc-docker/blob/master/README.md).

The Docker Engine for SmartDataCenter treats the entire data center as
a single Docker host. Each container is a SmartOS LX-branded zone. Benefits:

- [Zones](http://en.wikipedia.org/wiki/Solaris_Containers) have a
  proven security track record for isolation.
- LX-branded zones provide the abilty to run Linux binaries in SmartOS
  zones, meaning you can use Docker images without modification *and*
  without the overhead of hardware-based virtualization.
- [Overlay network](http://en.wikipedia.org/wiki/Overlay_network)
  support (VXLAN) means you have a private network between all your containers,
  across servers.

And the full stack is open source: [sdc-docker](https://github.com/joyent/sdc-docker),
[SmartDataCenter](https://github.com/joyent/sdc),
and [SmartOS](https://github.com/joyent/smartos-live).

**A note for users of Joyent's public cloud:** Joyent is hosting a beta of
their Docker service. Please sign up at https://www.joyent.com/lp/preview and
read on for the settings for the standard Docker client.


## Current Status

The Docker Engine for SDC is currently in alpha and under heavy development.
The current focus is on stabilization and filling out support for *building* and
*running* Docker containers.
Please [report issues](https://github.com/joyent/sdc-docker/issues),
give us feedback or discuss on [#joyent IRC on libera.chat](irc://libera.chat/#joyent).

### 3. sdc-docker-setup.sh

Now that you have access to a SmartDataCenter, we will set up authentication
to the Docker host. SDC Docker uses Docker's TLS authentication. This section
will show you how to create a TLS client certificate from the SSH key you
created in the previous section. Then we'll configure `docker` to send that
client certificate to identify requests as coming from you.

Follow the steps in [the API guide to get connected and start using SDC Docker](../api/README.md).


## Package Selection

If the docker client specifies either -m (memory) or -c (cpu\_shares), we'll look
{'fraction_non_alphanumeric': 0.07674705157542686, 'fraction_numerical': 0.002288329519450801, 'mean_word_length': 4.543414634146341, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3057774', 'n_tokens_mistral': 1642, 'n_tokens_neox': 1523, 'n_words': 732}