mirror of https://github.com/sosedoff/pgweb.git synced 2024-12-14 19:21:46 +03:00

Cross-platform client for PostgreSQL databases

cross-platform golang pgweb postgresql starred-repo starred-sosedoff-repo

Go to file

Dan Sosedoff b1dd4b5308 Add new CLI option to disable SSH connections		2017-09-26 23:56:27 -05:00
config	Rename examples to config, it's a proper name	2017-09-26 22:12:01 -05:00
data	Fall back to sslmode=disable if ssl mode is not set or invalid in bookmarks	2017-06-05 21:29:09 -05:00
Godeps	Fix deps again	2017-09-19 00:43:21 -05:00
pkg	Add new CLI option to disable SSH connections	2017-09-26 23:56:27 -05:00
screenshots	Update screenshots	2016-01-10 16:08:13 -06:00
script	Deprecate Boot2Docker in favor of Docker for Mac for integration testing	2016-11-03 20:05:50 -05:00
static	Allow setting ssh connection key file, fix connection ui	2017-09-26 23:29:28 -05:00
vendor	Fix deps again	2017-09-19 00:43:21 -05:00
.gitattributes	Do not show bindata.go in the git diff log	2016-01-08 15:34:02 -06:00
.gitignore	Add sample coverage file to gitignore	2015-03-04 08:53:41 -06:00
.travis.yml	Do not run CI on go 1.5/1.6	2017-09-22 22:08:32 -05:00
app.json	Merge pull request #90 from freeformz/patch-2	2015-07-14 21:19:55 -05:00
appveyor.yml	Fix appveyor builds	2016-01-04 18:51:25 -06:00
CHANGELOG.md	Update changelog and docker image	2017-08-04 21:58:43 -05:00
CONTRIBUTING.md	Specify how to run all tests	2017-06-05 21:30:53 -05:00
Dockerfile	Use alpine:3.6 as a docker base image	2017-08-09 23:11:30 -05:00
LICENSE	Update license years	2017-01-20 13:05:18 -06:00
main.go	Move all CLI logic into its own package	2017-05-16 21:28:07 -05:00
Makefile	Removed duplicate usage line in Makefile.	2017-04-27 05:16:10 -04:00
Procfile	Bind to 0.0.0.0 in Procfile	2014-11-05 22:15:05 -06:00
README.md	Update readme: premium features/donations	2017-09-16 21:28:06 -05:00
SCREENS.md	Update screenshots	2016-01-10 16:08:13 -06:00

README.md

pgweb

Web-based PostgreSQL database browser written in Go.

Overview

Pgweb is a web-based database browser for PostgreSQL, written in Go and works on OSX, Linux and Windows machines. Main idea behind using Go for backend development is to utilize ability of the compiler to produce zero-dependency binaries for multiple platforms. Pgweb was created as an attempt to build very simple and portable application to work with local or remote PostgreSQL databases.

See application screenshots

Features

Cross-platform support OSX/Linux/Windows 32/64-bit
Simple installation (distributed as a single binary)
Zero dependencies
Works with PostgreSQL 9.1+
SSH Connections
Multiple database sessions
Simple database browser
Execute and analyze custom SQL queries
Table and query data export to CSV/JSON/XML
Query history
Server bookmarks

Visit WIKI for more details

Demo

Visit https://pgweb-demo.herokuapp.com to see pgweb in action.

Installation

Precompiled binaries for supported operating systems are available.

More installation options

Usage

Start server:

pgweb

You can also provide connection flags:

pgweb --host localhost --user myuser --db mydb

Connection URL scheme is also supported:

pgweb --url postgres://user:password@host:port/database?sslmode=[mode]

Multiple database sessions

To enable multiple database sessions in pgweb, start the server with:

pgweb --sessions

Or set environment variable:

SESSIONS=1 pgweb

Deploy on Heroku

Testing

Before running tests, make sure you have PostgreSQL server running on localhost:5432 interface. Also, you must have postgres user that could create new databases in your local environment. Pgweb server should not be running at the same time.

Execute test suite:

make test

If you're using Docker locally, you might also run pgweb test suite against all supported PostgreSQL version with a single command:

make test-all

Contribute

Fork this repository
Create a new feature branch for a new functionality or bugfix
Commit your changes
Execute test suite
Push your code and open a new pull request
Use issues for any questions
Check wiki for extra documentation

Premium Features

If you or your company would like to sponsor a custom feature, please let me know via email (see contact section). Custom features are developed exclusively for the client and not committed to the public repo.

Donations

Pgweb is free and open source software, there's no plan to make a business out of it. If you wish to support the development, you can send a donation of any size using the following platforms:

Paypal: dan.sosedoff@gmail.com
Bitcoin: 1qAGohEhuNEkJEhHyEQfLgXAwY7dWRhmU

Any contribution is much appreciated.

Contact

License

The MIT License (MIT). See LICENSE file for more details.