## DynamoDB Dashboard
A Web GUI Dashboard for local or remote [DynamoDB](https://aws.amazon.com/blogs/aws/dynamodb-local-for-desktop-development/).
  
 
[](https://github.com/kritish-dhaubanjar/dynamodb-dashboard/actions/workflows/build.yml)
#### Installation:
Install application globally:
```shell
npm install --global dynamodb-dashboard
```
Start `dynamodb-dashboard` instance:
```shell
dynamodb-dashboard start
```
##### Options
- `-d, --debug` : show log output of running application (default: false)
- `-p, --port ` : port to run app (default: 4567)
- `-h, --host ` : host to run app (default: 127.0.0.1)
#### Setting Environment variables
Currently, following environment variables are supported:
- `AWS_REGION`
- `AWS_ENDPOINT`
- `AWS_ACCESS_KEY_ID`
- `AWS_SECRET_ACCESS_KEY`
- `AWS_SESSION_TOKEN`
To configure, set the AWS environment variables in the terminal session before launching `dynamodb-dashboard`, example in `.bashrc` file.
#### AWS Credentials Resolution
The application uses the AWS SDK for [JavaScript (v2)](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html), which supports multiple ways to load credentials automatically through the default credential provider chain.
- Explicit environment variables
- `AWS_ACCESS_KEY_ID`
- `AWS_SECRET_ACCESS_KEY`
- `AWS_SESSION_TOKEN` (optional)
> These take highest priority if provided.
- `~/.aws/credentials`
- AWS SSO sessions
- EC2/ECS instance metadata
- Other AWS SDK-supported sources
Set environment variables and start `dynamodb-dashboard` instance:
```shell
export AWS_REGION=us-west-2
export AWS_ENDPOINT=http://localhost:8000
export AWS_ACCESS_KEY_ID=fakeAccessKeyId
export AWS_SECRET_ACCESS_KEY=fakeSecretAccessKey
dynamodb-dashboard start
```
### Development Setup
1. [Setup Vue.js App](https://github.com/kritish-dhaubanjar/dynamodb-dashboard/tree/main/app)
2. [Setup Node Express Server](https://github.com/kritish-dhaubanjar/dynamodb-dashboard/tree/main/server)
**OR**
1. ```shell
git clone https://github.com/kritish-dhaubanjar/dynamodb-dashboard.git
```
2. ```shell
cd dynamodb-dashboard
```
3. ```shell
make watch
```
## Docker
Run a container (from Docker Hub)
1. ```shell
docker pull kritishdhaubanjar/dynamodb-dashboard:latest
```
2. ```shell
docker run \
--name dynamodb-dashboard \
-p 8080:4567 \
-e AWS_REGION=us-west-2 \
-e AWS_ENDPOINT=http://host.docker.internal:8000 \
-e AWS_ACCESS_KEY_ID=fakeAccessKeyId \
-e AWS_SECRET_ACCESS_KEY=fakeSecretAccessKey \
kritishdhaubanjar/dynamodb-dashboard:latest
```
## NGINX Config
To configure Nginx to serve dynamodb-dashboard with (EventSource (Server-Sent Events or SSE) event stream), you need to ensure Nginx is correctly set up to handle long-lived HTTP connections and provide appropriate headers. Here's a basic example configuration:
```nginx
server
{
listen 80;
listen [::]:80;
server_name _;
proxy_read_timeout 1d;
proxy_send_timeout 1d;
proxy_connect_timeout 1d;
location /
{
proxy_pass http://localhost:4567;
}
location /dynamodb/api/database/stream/
{
proxy_buffering off;
proxy_cache off;
chunked_transfer_encoding off;
add_header Content-Type text/event-stream;
add_header Cache-Control no-cache;
add_header Connection keep-alive;
proxy_pass http://localhost:4567;
}
}
```
### Preview:
### Demo:
https://user-images.githubusercontent.com/25634165/192109458-a621bc06-788d-4d54-9dc2-9064380ee837.mp4
[](https://www.buymeacoffee.com/kritishdhaubanjar)
## Contributors ✨
Thanks goes to these wonderful people:
# License
Distributed under the MIT License. See `LICENSE` for more information.
