mirror of https://github.com/sosedoff/pgweb.git synced 2024-12-15 03:36:33 +03:00

Cross-platform client for PostgreSQL databases

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

Go to file

Dan Sosedoff 2f26756bb0 Change 'make deps' to 'make setup' to fix issues with clean checkout		2014-10-24 20:52:15 -05:00
screenshots	Fix screenshots	2014-10-14 11:26:22 -05:00
static	Implement export to CSV via new browser window	2014-10-21 07:40:45 -07:00
.gitignore	Serve assets with bindata	2014-10-13 14:40:56 -05:00
api.go	Set a correct content type header for CSV endpoint	2014-10-18 08:15:13 -07:00
API.md	Update docs	2014-10-11 13:40:15 -05:00
client.go	Set a correct content type header for CSV endpoint	2014-10-18 08:15:13 -07:00
LICENSE	License, readme	2014-10-13 21:02:04 -05:00
main.go	Version bump: 0.2.0	2014-10-23 10:12:50 -06:00
Makefile	Change 'make deps' to 'make setup' to fix issues with clean checkout	2014-10-24 20:52:15 -05:00
README.md	Add features list	2014-10-23 09:11:40 -06:00
TODO.md	Update todo	2014-10-23 09:07:11 -06:00

README.md

pgweb

Web-based PostgreSQL database browser written in Go.

Overview

This is a web-based browser for PostgreSQL database server. Its written in Go and works on Mac OSX, Linux and Windows machines. Main idea behind using Go for the backend is to utilize language's ability for cross-compile source code for multiple platforms. This project is an attempt to create a very simple and portable application to work with PostgreSQL databases.

Features:

Connect to local or remote server
Browse tables and table rows
Get table details: structure, size, indices, row count
Execute SQL query and run analyze on it
Export query results to CSV
View query history

Installation

Please visit Github Releases to download a precompiled binary for your operating system.

Currently supported:

Mac OSX 64bit
Linux 32/64bit
Windows 32/64bit

Supported PostgreSQL versions:

Older versions of PostgreSQL might also work but this project is not tested on 8.x branches.

Usage

Start server:

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

You can also specify a connection URI instead of individual flags:

pgweb --url postgresql://user:password@host:port/database

It works great with Heroku Postgres if you need to troubleshoot production database or simply run a few queries.

Full CLI options:

Usage:
  pgweb [OPTIONS]

Application Options:
  -v          Print version
  -d          Enable debugging mode (false)
      --url=  Database connection string
      --host= Server hostname or IP (localhost)
      --port= Server port (5432)
      --user= Database user (postgres)
      --db=   Database name (postgres)
      --ssl=  SSL option (disable)

Compile from source

Go 1.3+ is required. You can install Go with homebrew:

brew install go

To compile source code run the following command:

make deps
make dev

This will produce pgweb binary in the current directory.

There's also a task to compile binaries for other operating systems:

make build

Under the hood it uses gox. Compiled binaries will be stored into ./bin directory.

Contributors

Dan Sosedoff - https://twitter.com/sosedoff
Masha Safina - https://twitter.com/mashasafina

License

The MIT License (MIT)