Skip to content
This repository has been archived by the owner on Apr 17, 2023. It is now read-only.

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
shnhrrsn committed Mar 26, 2017
1 parent 550de9e commit 048baf6
Showing 1 changed file with 18 additions and 8 deletions.
26 changes: 18 additions & 8 deletions README.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Marina is a CLI tool to provide simple, shareable domains by creating a reverse proxy with [Caddy](https://caddyserver.com) and serving `*.dev` via Dnsmasq. No need to mess with hosts files, quickly and easily turn `http://localhost:3000` into `http://domain.dev`.

Marina also integrates with [ngrok](https://ngrok.com) allowing you to create a publicly shareable link with a simple `share` command.
Marina also integrates with [ngrok](https://ngrok.com) allowing you to create a publicly shareable link with a simple `marina share` command.

Marina was inspired by [Laravel Valet](http://github.com/laravel/valet), however running Marina and Valet side by side is not supported.

Expand All @@ -15,14 +15,24 @@ sudo marina install

## Usage

* `marina dock`: Register the a project with Marina
* `marina undock`: Unregister the a project with Marina
* `marina list`: Lists all registered domains.
* `marina share`: Generate a shareable URL for a project.
* `marina install`: Install the Marina toolchain
* `marina uninstall`: Uninstall the Marina toolchain
#### Managing Projects
* `dock`: Register a project with Marina
* `list`: Lists all registered domains.
* `open`: Opens a Marina project in the browser.
* `share`: Generate a shareable URL for a project.
* `undock`: Unregister a project with Marina

#### Managing the Toolchain
* `install`: Install the Marina toolchain
* `uninstall`: Uninstall the Marina toolchain
* `update`: Update the Marina toolchain

#### Manage Services
* `start`: Start Caddy & Dnsmasq
* `stop`: Stop Caddy & Dnsmasq
* `restart`: Restart Caddy & Dnsmasq

### --save
When running `marina dock` pass the `--save` flag (ex: `marina dock --save`) to persist your settings. This will enable Marina to save the domain/source host settings to a `.marina.json` file in the current directory.

The `dock`, `undock` and `share` commands will read from `.marina.json` if it exists, allowing you to quickly run those commands without needing to specify a domain.
The `dock`, `undock`, `open` and `share` commands will read from `.marina.json` if it exists, allowing you to quickly run those commands without needing to specify a domain.

0 comments on commit 048baf6

Please sign in to comment.