Skip to main content

Docker-remote is a wrapper for docker-compose to manage compositions on a remote machine easily.

Project description

# Docker Remote

<a href="">
<img align="right" src="" alt="License: MIT">



Remote is a tool for managing Docker applications via [Compose] on another
machine. It uses SSH tunnels to connect your Docker and Docker Compose client
with your Docker Host. It is useful as an alternative to [Machine] or to
deploy an app on a server without manually loggin in via SSH.

$ cat docker-compose.yml
version: '3.4'
image: nginx
name: myapp

$ docker-remote compose up --build --detach
$ docker-remote docker ps

Docker Remote sets the `DOCKER_HOST` environment variable when invoking
`docker` or `docker-compose`. You can use `docker-remote shell` to enter
a shell with a tunnel set up and the environment variable set, then omit
the `docker-remote` prefix on Docker commands.

$ docker-remote shell
Setting up a docker-compose alias...

$ alias && echo $DOCKER_HOST
alias docker-compose='docker-remote compose'

$ docker ps

The host to which a connection is opened can be specified in the
`x-docker-remote` section of the Docker Compose configuration or in the
`~/.docker-remote.yml` configuration file.

user: me
remotepy: /home/me/.local/bin/docker-remote.core.remotepy

The `remote.remotepy` option is necessary if the `docker-remote.core.remotepy`
command is not in the `PATH` of your user.

Check out the [Documentation](docs/) for installation instructions and


* Allows you to compose and manage applications remotely
* Pre-processes your Docker Compose configuration in order to place all
named and relative volume names inside a project directory.
* Ability to automatically add a `dockerhost` hostname to `/etc/hosts` for
all or selected services


<p align="center">Copyright &copy; 2018 Niklas Rosenstein</p>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for docker-remote, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size docker-remote-1.1.0.tar.gz (13.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page