Local Development

​

Prerequisites

• Git
• Docker
• Docker Compose (usually comes with Docker Desktop)
• [Node & NPM] (https://nodejs.org/en/download)

​

Getting started

​

Clone the repository

git clone https://github.com/browserable/browserable.git
cd browserable

​

Start the development environment

docker compose -f deployment/docker-compose.dev.yml up

• UI Server (http://localhost:2001)
• Tasks Server (http://localhost:2003)
• MongoDB (port 27017)
• MongoDB Express UI (http://localhost:3300)
• Redis (port 6379)
• MinIO Object Storage:
  • API (http://localhost:9000)
  • Console (http://localhost:9001)
• Supabase Services:
  • Database (port 5432)
• Docs (http://localhost:2002)

​

Start the local browser service

cd browser
npm install

npm start

​

Available Interfaces

1. Main Application UI
   • URL: http://localhost:2001
   • The main Browserable user interface
2. Tasks Server
   • URL: http://localhost:2003
   • Handles background tasks and browser automation
3. MongoDB Express
   • URL: http://localhost:3300
   • Username: admin
   • Password: pass
   • Web interface for managing MongoDB data
4. MinIO Console
   • URL: http://localhost:9001
   • Username: browserable-storage
   • Password: secret1234
   • Object storage management interface

​

Development Workflow

​

Project Structure

• ui/ - Frontend React application
• tasks/ - Backend services and task management
• deployment/ - Docker and deployment configurations
• docs/ - Documentation files

​

Stopping services

1. Use Ctrl+C to stop the local browser service.
2. Run npx browserable down to bring down the docker services. (or run docker compose -f deployment.dev.yml down inside the browserable/deployment folder)

​

Getting Help

• Join our Discord community
• Report issues on our GitHub repository