Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huggingface/Mongoku
🔥The Web-scale GUI for MongoDB
https://github.com/huggingface/Mongoku
admin administration angular mongo mongodb node node-mongodb typescript web
Last synced: about 1 month ago
JSON representation
🔥The Web-scale GUI for MongoDB
- Host: GitHub
- URL: https://github.com/huggingface/Mongoku
- Owner: huggingface
- License: mit
- Created: 2018-02-10T13:04:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T03:21:23.000Z (4 months ago)
- Last Synced: 2024-06-20T02:36:11.520Z (3 months ago)
- Topics: admin, administration, angular, mongo, mongodb, node, node-mongodb, typescript, web
- Language: TypeScript
- Homepage:
- Size: 1.4 MB
- Stars: 1,292
- Watchers: 62
- Forks: 81
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - huggingface/Mongoku - 🔥The Web-scale GUI for MongoDB (TypeScript)
- awesome-mongodb - Mongoku - MongoDB client for the web (Tools / Web)
- awesome-mongodb - Mongoku - MongoDB client for the web (Tools / Web)
README
# Mongoku
MongoDB client for the web. Query your data directly from your browser. You can host it locally,
or anywhere else, for you and your team.
It scales with your data (at Hugging Face we use it on a 1TB+ cluster) and is blazing fast for all
operations, including sort/skip/limit. Built on TypeScript/Node.js/Angular.
### Demo
### Install & Run
This is the easy and recommended way of installing and running Mongoku.
```
# Install
npm install -g mongoku
# Run from your current terminal
mongoku start
```
You can also run Mongoku as a daemon, using either [PM2](https://github.com/Unitech/pm2) or
[Forever](https://github.com/foreverjs/forever).
```
mongoku start --pm2
# or
mongoku start --forever
```
### Docker
#### Using the Docker HUB image
```
docker run -d --name mongoku -p 3100:3100 huggingface/mongoku
# Run with customized default hosts
docker run -d --name mongoku -p 3100:3100 --env MONGOKU_DEFAULT_HOST="mongodb://user:[email protected]:8888" huggingface/mongoku
```
#### Build your own image
If you want to build your own docker image, just clone this repository and run the following:
```
# Build
docker build -t yournamehere/mongoku .
# Run
docker run -d --name mongoku -p 3100:3100 yournamehere/mongoku
```
### Manual Build
If you want to manually build and run mongoku, just clone this repository and run the following:
```bash
# Install the angular cli if you don't have it already
npm install -g typescript @angular/cli
npm install
# Build the front
cd app
npm install
ng build
# And the back
cd ..
tsc
# Run
node dist/server.js
```
### Configuration
You can also specify a few things using environment variables:
```
# Use some customized default hosts (Default = localhost:27017)
MONGOKU_DEFAULT_HOST="mongodb://user:password@localhost:27017;localhost:27017"
# Use another port. (Default = 3100)
MONGOKU_SERVER_PORT=8000
# Use a specific file to store hosts (Default = $HOME/.mongoku.db)
MONGOKU_DATABASE_FILE="/tmp/mongoku.db"
# Timeout before falling back to estimated documents count in ms (Default = 5000)
MONGOKU_COUNT_TIMEOUT=1000
# Read-only mode
MONGOKU_READ_ONLY_MODE=true
```