Getting Started with SharkCluster
Installation
SharkCluster is a self-hosted solution for managing Supabase instances. Follow these steps to get started.
Prerequisites
- Ubuntu 20.04 or later (or compatible Linux distribution)
- Docker and Docker Compose installed
- Node.js 16+ installed
- At least 2GB RAM and 20GB storage
Installation Steps
- Clone the repository:
git clone https://github.com/magento-dev2/sharkcluster2026.git cd sharkcluster2026 - Install dependencies:
npm install - Configure environment variables:
cp .env.example .env # Edit .env with your settings - Start the services:
docker-compose up -d npm run dev
Quick Start
1. Access SharkCluster Dashboard
Open your browser and navigate to: http://localhost:3000
2. Create a Server
Add your server connection details (SSH credentials, domain, etc.)
3. Deploy Supabase
Click "Install Supabase" and follow the deployment wizard. This will take 5-10 minutes.
4. Access Your Instance
Once deployed, click "Open Studio" to access your Supabase dashboard.
Configuration
Environment Variables
SharkCluster uses the following key environment variables:
| Variable | Description | Example |
|---|---|---|
DATABASE_URL | SharkCluster database connection | postgresql://user:pass@localhost/sharkcluster |
JWT_SECRET | Secret key for JWT tokens | your-secret-key-here |
SUPABASE_VERSION | Supabase version to deploy | 1.0.0-slice1 |
Network Configuration
Make sure the following ports are accessible:
3000- Dashboard UI3001- API Server5432- PostgreSQL (internal)80/443- Supabase instances (reverse proxy)
Next Steps
Now that you have SharkCluster set up, explore the following: