# heroku-db

> A Heroku Toolbelt plugin for DATABASE_URL dump and restore

Latest version **1.0.0** (published 2015-05-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install heroku-db
pnpm add heroku-db
yarn add heroku-db
bun add heroku-db
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2015-05-14 |
| First published | 2015-05-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Robert Coleman |
| Maintainers | rjocoleman |
| Keywords | heroku-plugin |

## Links

- npm: https://www.npmjs.com/package/heroku-db
- Repository: https://github.com/rjocoleman/heroku-db
- Issues: https://github.com/rjocoleman/heroku-db/issues
- npm.io page: https://npm.io/package/heroku-db

## Dependencies (3)

- [shelljs](https://npm.io/package/shelljs.md) ^0.4.0
- [heroku-cli-util](https://npm.io/package/heroku-cli-util.md) ^3.5.2
- [parse-database-url](https://npm.io/package/parse-database-url.md) ^0.2.2

## Recent versions

- 1.0.0 (latest) — 2015-05-14

## README

Heroku DB CLI Plugin
====================

This is a Heroku Toolbelt CLI plugin to interact with databases at `DATABASE_URL`. Not dependent on Heroku Postgres.

Features:

* Dump `DATABASE_URL` to local filesystem.
* Restore a database dump to an app or an arbitrary database URI.

You can install this plugin by:

```sh
$ heroku plugins:install heroku-db
```


## Usage:

```sh
$ heroku help db
```


#### db:dump

Dump the an app's `DATABASE_URL` to the current directory.


#### db:restore DATABASE_URL DUMP_FILE

Restores a database dump.

```sh
$ heroku db:restore postgresql://user:host@localhost:5432/dbname foo-application.dump
```


## Supported Databases

Currently only Postgresql is supported.

PRs are welcome for other databases.


## Known issues

* `--confirm` flag on dump doesn't work.

---
_Source: https://npm.io/package/heroku-db · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._