README.md 5.2 KB
Newer Older
S
Sercan Özdemir 已提交
1 2
## Mongoclient, MongoDB Management Tool
Cross-platform, easy to use, MongoDB 3.4+ support and more features!
S
Sercan Özdemir 已提交
3

S
Sercan Özdemir 已提交
4 5 6
[![Build Status](https://travis-ci.org/rsercano/mongoclient.svg?branch=master)](https://travis-ci.org/rsercano/mongoclient)
[![Code Climate](https://codeclimate.com/github/rsercano/mongoclient/badges/gpa.svg)](https://codeclimate.com/github/rsercano/mongoclient)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/6a75fc4e1d3f480f811b5339202400b5)](https://www.codacy.com/app/ozdemirsercan27/mongoclient?utm_source=github.com&utm_medium=referral&utm_content=rsercano/mongoclient&utm_campaign=Badge_Grade)
S
Sercan Özdemir 已提交
7 8
[![GitHub release](https://img.shields.io/github/release/rsercano/mongoclient.svg)](https://github.com/rsercano/mongoclient)
[![Github All Releases](https://img.shields.io/github/downloads/rsercano/mongoclient/total.svg)](https://github.com/rsercano/mongoclient)
S
Sercan Özdemir 已提交
9
[![Docker Pulls](https://img.shields.io/docker/pulls/mongoclient/mongoclient.svg)](https://hub.docker.com/r/mongoclient/mongoclient/)
S
Sercan Özdemir 已提交
10
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/rsercano/mongoclient/blob/master/LICENSE)
S
Sercan Özdemir 已提交
11

S
Sercan Özdemir 已提交
12
[![Paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y5VD95E96NU6S)
S
Sercan Özdemir 已提交
13

S
Sercan Özdemir 已提交
14
*Mongoclient is in need of you to buy [INSPINA](https://wrapbootstrap.com/theme/inspinia-responsive-admin-theme-WB0R5L90S) theme's extended licence ($1000) to live longer. Thank you so much ! [Here's the list of donators, helpful people](https://github.com/rsercano/mongoclient/wiki/Donators) Can't you donate, no worries giving a star to this repository is free  and appreciated as much as donation !*
S
Sercan Özdemir 已提交
15

S
Sercan Özdemir 已提交
16
[Try Demo Application](http://www.mongoclient.com:3000)
S
Sercan Özdemir 已提交
17

S
Sercan Özdemir 已提交
18
   Database Monitoring     | Easy GridFS, Dump/Restore Management
S
Sercan Özdemir 已提交
19
-------------------------|-------------------------
S
Sercan Özdemir 已提交
20
<img src="http://mongoclient.com/img/ss/main_view.png" width="400">  | <img src="http://mongoclient.com/img/ss/file.png" width="400">
S
Sercan Özdemir 已提交
21

S
Sercan Özdemir 已提交
22
   Autocomplete     | User Management
S
Sercan Özdemir 已提交
23
-------------------------|-------------------------
S
Sercan Özdemir 已提交
24
<img src="http://mongoclient.com/img/ss/auto_complete.png" width="400">  | <img src="http://mongoclient.com/img/ss/um.png" width="400">
S
Sercan Özdemir 已提交
25

S
Sercan Özdemir 已提交
26
<img src="http://www.mongoclient.com/img/logo/head_only_medium.png" align="left" hspace="10" vspace="6">
S
Sercan Özdemir 已提交
27

S
Sercan Özdemir 已提交
28
## Download
S
Sercan Özdemir 已提交
29
Version 1.5.0 has been released !
S
Sercan Özdemir 已提交
30 31 32

### Distributions

S
Sercan Özdemir 已提交
33 34 35
* [Linux x64](https://github.com/rsercano/mongoclient/releases/download/1.5.0/linux-portable-x64.zip)
* [Windows x64](https://github.com/rsercano/mongoclient/releases/download/1.5.0/windows-portable-x64.zip)
* [OSx](https://github.com/rsercano/mongoclient/releases/download/1.5.0/osx-portable.zip)
S
Sercan Özdemir 已提交
36
* [Web Application](https://github.com/rsercano/mongoclient/wiki#31-compile-from-source-browser-edition)
S
Sercan Özdemir 已提交
37 38

To learn more see the [wiki](https://github.com/rsercano/mongoclient/wiki) page.
S
Sercan Özdemir 已提交
39 40
<br/>
<br/>
S
Sercan Özdemir 已提交
41
## Docker
S
Sercan Özdemir 已提交
42
Mongoclient now officialy has a docker hub. To install master branch:
S
Sercan Özdemir 已提交
43 44 45

```docker pull mongoclient/mongoclient```

S
Sercan Özdemir 已提交
46
To install latest stable release:
S
Sercan Özdemir 已提交
47

S
Sercan Özdemir 已提交
48
```docker pull mongoclient/mongoclient:1.5.0```
S
Sercan Özdemir 已提交
49

S
typo  
Sercan 已提交
50
Then you can run it as a daemon:
S
Sercan Özdemir 已提交
51 52 53

```docker run -d -p 3000:3000 mongoclient/mongoclient```

S
Sercan Özdemir 已提交
54 55
To set an external mongodb which is required for meteor to work, you can set ```MONGO_URL``` environment variable. Otherwise mongoclient will install mongodb to container and use it.

S
Sercan Özdemir 已提交
56 57
To persist your connections and settings simply bind ```/data/db``` directory to your local machine as below.

S
Sercan Özdemir 已提交
58
```docker run -d -p 3000:3000 -v <your_path>:/data/db mongoclient/mongoclient```
S
Sercan Özdemir 已提交
59

Y
Yacloud Co.,Ltd 已提交
60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
## Cloud Foundry
You can optionally push the Mongoclient to the CloudFoundry

Cloud Foundry or CF, is a PaaS, as a developer you can trail the instance of CF, either [IBM Bluemix](https://console.ng.bluemix.net) or [Pivotal](https://console.run.pivotal.io) 

As the MongoClient is developed by the meteor, you need to have an mongodb instance to store the metadata info MC needed.
[Mlab](https://mlab.com) has an experimental or sandbox offering or [compose](https://www.compose.com/) a commerical DBaaS provider you can register and try it.

Assuming you have an mongodb instance, which something linke  
``` mongodb://<dbuser>:<dbpassword>@ds145188.mlab.com:45188/mongodb-mc ```

And installed the [command line utility](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html)

Get the latest MongoClient

```
S
Sercan Özdemir 已提交
76
git clone https://github.com/rsercano/mongoclient.git ~/mongoclient
Y
Yacloud Co.,Ltd 已提交
77 78 79 80 81 82 83 84 85 86 87 88 89
cd ~/mongoclient
```

edit the manifest.yml.sample, change the corresponding values to your environment

```
mv manifest.yml.sample manifest.yml
cf login -a api.ng.bluemix.net -u username -p password
cf push
```

after a while, your console will output something like 

S
Sercan Özdemir 已提交
90
![cf push mongoclient](https://cloud.githubusercontent.com/assets/3640368/21992923/117db29c-dc21-11e6-80c0-b2a246c0ae70.png)
Y
Yacloud Co.,Ltd 已提交
91

R
rsercano 已提交
92
## History
S
Sercan Özdemir 已提交
93 94 95 96
Please check [history](https://github.com/rsercano/mongoclient/blob/master/HISTORY.MD) file for version information.

## Roadmap
Please check [roadmap](https://github.com/rsercano/mongoclient/blob/master/ROADMAP.MD) file for further features.
S
Sercan Özdemir 已提交
97

S
Sercan Özdemir 已提交
98 99
## License
Project is licensed under [MIT](https://en.wikipedia.org/wiki/MIT_License), which means you are free to do anything with full of my work as long as you provide attribution back to me. Thanks !