https://github.com/docker-archive/docker-snap
https://github.com/docker-archive/docker-snap
Last synced: 12 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/docker-archive/docker-snap
- Owner: docker-archive
- License: mit
- Archived: true
- Created: 2017-01-25T00:50:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-11-28T21:11:40.000Z (over 7 years ago)
- Last Synced: 2024-11-25T09:45:12.293Z (over 1 year ago)
- Language: Shell
- Size: 103 KB
- Stars: 120
- Watchers: 19
- Forks: 26
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Snap
:lock: This repository has been archived.
> *NOTE:* The Docker Snap is no longer maintained by Docker, Inc. The last
> release version was 17.06.2. The future of the Docker Snap is unclear, but it
> won't be developed here going forward. The source at
> https://code.launchpad.net/~docker/+git/snap appears to be where new
> development efforts are taking place, and the Snapcraft forums
> (https://forum.snapcraft.io/) are probably your best bet to reach the new
> maintainers.
---
This repository contains the source for the `docker` snap package. The package provides a distribution of Docker Community Edition (CE) for Ubuntu Core 16 (and other snap-compatible) systems. It is built from an upstream Docker CE release tag with some patches to fit the snap format and is available on `armhf`, `arm64`, `amd64`, `i386`, and `ppc64el` architectures. The rest of this page describes installation, usage, and development.
## Installation
To install the latest stable release of Docker CE using `snap`:
$ sudo snap install docker
If you are using Ubuntu Core 16,
* Connect the `docker:home` plug as it's not auto-connected by default:
$ sudo snap connect docker:home
If you are using an alternative snap-compatible Linux distribution ("classic" in snap lingo), and would like to run `docker` as a normal user:
* Create and join the `docker` group.
$ sudo addgroup --system docker
$ sudo adduser $USER docker
$ newgrp docker
* You will also need to disable and re-enable the `docker` snap if you added the group while it was running.
$ sudo snap disable docker
$ sudo snap enable docker
## Usage
Docker should function normally, with the following caveats:
* All files that `docker` needs access to should live within your `$HOME` folder.
* If you are using Ubuntu Core 16, you'll need to work within a subfolder of `$HOME` that is readable by root. https://github.com/docker/docker-snap/issues/8
* `docker-compose` is available as `docker.compose` due to snap naming restrictions.
* Additional certificates used by the Docker daemon to authenticate with registries need to be located in `/var/snap/docker/common/etc/certs.d` instead of `/etc/docker/certs.d`.
### Examples
* [Setup a secure private registry](registry-example.md)
## Development
Developing the `docker` snap package is typically performed on a "classic" Ubuntu distribution. The instructions here are written for Ubuntu 16.04 "Xenial".
* Install the snap tooling (requires `snapd>2.21` and `snapcraft>=2.26`):
$ sudo apt-get install snapd snapcraft
$ sudo snap install core
* Checkout this repository and build the `docker` snap package:
$ git clone https://github.com/docker/docker-snap
$ cd docker-snap
$ sudo snapcraft
* Install the newly-created snap package:
$ sudo snap install --dangerous docker_[VER]_[ARCH].snap
* Manually connect the relevant plugs and slots which are not auto-connected:
$ sudo snap connect docker:privileged :docker-support
$ sudo snap connect docker:support :docker-support
$ sudo snap connect docker:firewall-control :firewall-control
$ sudo snap connect docker:docker-cli docker:docker-daemon
$ sudo snap disable docker
$ sudo snap enable docker
You should end up with output similar to:
$ sudo snap interfaces docker
Slot Plug
:docker-support docker:privileged,docker:support
:firewall-control docker
:home docker
:network docker
:network-bind docker
docker:docker-daemon docker:docker-cli