| .. 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. |
| |
| .. _install/docker: |
| |
| ======================= |
| Installation via Docker |
| ======================= |
| |
| Apache CouchDB provides 'convenience binary' Docker images through |
| Docker Hub at ``apache/couchdb``. This is our upstream release; it |
| is usually mirrored downstream at Docker's top-level ``couchdb`` |
| as well. |
| |
| At least these tags are always available on the image: |
| |
| * ``latest`` - always the latest |
| * ``3``: always the latest 3.x version |
| * ``2``: always the latest 2.x version |
| * ``1``, ``1.7``, ``1.7.2``: CouchDB 1.7.2 (convenience only; no longer supported) |
| * ``1-couchperuser``, ``1.7-couchperuser``, ``1.7.2-couchperuser``: CouchDB |
| 1.7.2 with couchperuser plugin (convenience only; no longer supported) |
| |
| These images expose CouchDB on port ``5984`` of the container, run everything |
| as user ``couchdb`` (uid ``5984``), and support use of a Docker volume for data |
| at ``/opt/couchdb/data``. |
| |
| **Your installation is not complete. Be sure to complete the** |
| :ref:`Setup <setup>` **steps for a single node or clustered installation.** |
| |
| Further details on the Docker configuration are available in our |
| `couchdb-docker git repository`_. |
| |
| .. _couchdb-docker git repository: https://github.com/apache/couchdb-docker |