Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aj-may/dotdocker

🐳 A utility to help setup a docker development environment with host based routing
https://github.com/aj-may/dotdocker

developer-tools development-environment dnsmasq docker nginx-proxy

Last synced: about 2 months ago
JSON representation

🐳 A utility to help setup a docker development environment with host based routing

Host: GitHub
URL: https://github.com/aj-may/dotdocker
Owner: aj-may
License: mit
Created: 2019-06-11T01:43:22.000Z (over 5 years ago)
Default Branch: main
Last Pushed: 2023-02-08T15:14:44.000Z (over 1 year ago)
Last Synced: 2024-07-22T04:38:46.429Z (2 months ago)
Topics: developer-tools, development-environment, dnsmasq, docker, nginx-proxy
Language: JavaScript
Homepage:
Size: 121 KB
Stars: 40
Watchers: 11
Forks: 10
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        ![dotdocker](https://dotdocker-github-header.now.sh)

A utility to help setup a docker development environment with host based routing

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

[![version](https://img.shields.io/npm/v/dotdocker.svg?style=flat)](https://www.npmjs.com/package/dotdocker)

[![MIT License](https://img.shields.io/npm/l/dotdocker.svg?style=flat)](https://github.com/aj-may/dotdocker/blob/master/LICENSE)

[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat)](https://github.com/prettier/prettier)

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=flat)](http://commitizen.github.io/cz-cli/)

![GitHub All Releases](https://img.shields.io/github/downloads/aj-may/dotdocker/total.svg?style=flat)

- [Installation](#installation)

  - [Using homebrew](#using-homebrew)

  - [Using npm](#using-npm)

- [Usage](#usage)

## Installation

### Using homebrew

```sh

brew install aj-may/dotdocker/dotdocker

```

### Using npm

To install `dotdocker` globally using `npm`, run the following:

```sh

npm install -g dotdocker

```

## Usage

Before Starting `dotdocker`, make sure you are not running any other software that is listening on

ports 53, 80, or 443. This will cause the command to fail. To allow the script to modify your

systems DNS configuration, it may ask you to run the command with `sudo` the first time the script

is run. Once configured, the script can be run with normal privileges.

```text

Usage: dotdocker [options] [command]

A utility to help setup a docker development environment with host based routing

Options:

  -V, --version  output the version number

  -h, --help     output usage information

Commands:

  start          Pull and start the proxy container and configure DNS

  stop           Stop the proxy container

  restart        Restart the proxy container

```