Skip to main content

Overview

The Databite dashboard is a Next.js application that provides a web interface for managing your Databite server. This guide covers how to clone, configure, and deploy the dashboard.

Prerequisites

  • Node.js >= 18.0.0
  • A running Databite server
  • Git

Step 1: Clone the Repository

git clone https://github.com/DatabiteDev/databite.git
cd databite/packages/dashboard

Step 2: Install Dependencies

npm install

Step 3: Configure Environment Variables

Create a .env.local file in the dashboard directory:
# URL of your Databite server
NEXT_PUBLIC_API_URL=http://localhost:3001

Step 4: Build and Run Locally

# Development mode
npm run dev

# Production build
npm run build
npm start
The dashboard will be available at http://localhost:3000.

Deployment Options

The dashboard can be deployed to any platform that supports Next.js:
  • Vercel
  • Netlify
  • Heroku
  • Self-hosted

Security Configuration

Ensure your Databite server allows requests from your dashboard domain:
const server = new DatabiteServer({
  // ... other config
  security: {
    allowedOrigins: ["https://your-dashboard-domain.com"],
    enableHelmet: true,
    enableRateLimit: true,
  },
});

Troubleshooting

  • Verify NEXT_PUBLIC_API_URL is correct
  • Check CORS settings on your server
  • Ensure the server is running and accessible

Next Steps