https://github.com/davidmyersdev/dx
Safely execute commands in the current directory with Docker. Forget about dependencies.
https://github.com/davidmyersdev/dx
bash docker
Last synced: about 1 month ago
JSON representation
Safely execute commands in the current directory with Docker. Forget about dependencies.
- Host: GitHub
- URL: https://github.com/davidmyersdev/dx
- Owner: davidmyersdev
- License: mit
- Created: 2021-03-04T04:30:58.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-10-16T19:41:58.000Z (over 4 years ago)
- Last Synced: 2025-09-26T00:40:01.190Z (8 months ago)
- Topics: bash, docker
- Language: Shell
- Homepage:
- Size: 618 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dx
Safely execute commands in the current directory with Docker. Forget about dependencies.
## Install
The only dependency is [Docker](https://www.docker.com/).
```shell
# clone the repo
git clone https://github.com/voraciousdev/dx.git
# make it available anywhere
mv ./dx/dx /usr/local/bin
```
## Use
You can run `dx -h` for usage info and examples.
```shell
Usage
dx [-hs][-i ][-p ]
Options
-h show usage info
-i specify a docker image to use (e.g. node:lts-alpine)
-p specify port binding (as host:guest) for docker (e.g. 5000:80)
-s launch an interactive shell
Examples
dx npx cowsay hello
dx bundle exec rails c
dx youtube-dl https://youtu.be/LfhkoCAK6aA
dx -i node:lts-alpine npm init
dx -p 5001:5001 dotnet run
dx -s composer
```
### Examples
Download a YouTube video with `youtube-dl`.
```shell
dx youtube-dl https://youtu.be/LfhkoCAK6aA
```
Convert a video to a GIF with `ffmpeg`.
```shell
dx ffmpeg -i input.mp4 -loop 0 -c:v gif -f gif output.gif
```
The current directory is mounted in a Docker [volume](https://docs.docker.com/engine/reference/commandline/run/#mount-volume--v---read-only) and set as the [working directory](https://docs.docker.com/engine/reference/commandline/run/#set-working-directory--w) inside the container at `/dxdir`.
### Supported commands
This is a (growing) list of supported commands to run as `dx `.
- `cargo`
- `deno`
- `dotnet`
- `ffmpeg`
- `node` `npm` `npx` `yarn`
- `php` `composer`
- `python` `pip`
- `ruby` `bundle` `bundler` `gem` `irb`
- `youtube-dl`
#### Run any command by specifying a Docker image
If a command is not yet supported, you can still use `dx` by specifying a Docker image to use with the `-i` flag.
```shell
dx -i node:lts-alpine npm init
```
### Expose a port to the host
Expose a port to the host with the `-p` flag.
```shell
# just like a docker port binding (host:guest)
dx -p 5000:5000 npx serve .
```
### Run multiple commands by launching an interactive shell
Launch an interactive shell for a given command with the `-s` flag.
```shell
dx -s composer
```