Skip to content

Conversation

@tazmon95
Copy link

🔧 Port Parameterization

  • Centralized all service ports in .env PORTS section
  • External and internal port configuration
  • Configurable bind IP address
  • Full backward compatibility

🔗 External Supabase Support

  • --ext-supabase PATH flag for existing installations
  • Dual-mode operation (internal vs external)
  • Safety checks and user warnings
  • Clean output with orphan warning suppression

📚 Documentation & Polish

  • Comprehensive CLAUDE.md for developers
  • Enhanced error handling and user guidance
  • Quiet mode for cleaner Docker output

coleam00 and others added 9 commits June 8, 2025 09:00
* Remove all port mappings between the host machine and the containers

* Add expose elements for informative purposes

* Add concept of environment and reset Supabase ports in public environment

* Remove network_mode host from Caddy service

* Open ports on localhost, when in private environment

* Update README.md to include explanation of environment argument

* Comment out endpoints without authentication in Caddyfile

* Fix Caddy configuration to use container names and not localhost

* Update README.md

Added "-b stable" as this is now the release state

* Updating .env.example to go along with Supabase .env changes

* Note in README for deploying to VPS without Docker Compose

---------

Co-authored-by: Benny Tops <[email protected]>
Co-authored-by: Leex <[email protected]>
- **Files not Found in Supabase Folder** to troubleshooting section
# Pool size for internal metadata storage used by Supavisor
# This is separate from client connections and used only by Supavisor itself
POOLER_DB_POOL_SIZE=5
## Summary
- Add centralized port configuration in .env file for all services
- Add support for external Supabase installations via --ext-supabase flag
- Improve script output with cleaner logging and warning suppression
- Add comprehensive CLAUDE.md documentation for development guidance

## Features Added

### Port Parameterization
- Centralized PORTS section in .env.example with environment variables for all service ports
- External ports (host access) and internal ports (inter-service) separately configurable
- Configurable bind IP address for private environment (default: 127.0.0.1)
- Updated docker-compose.yml, override files, and Caddyfile to use port variables
- Backward compatibility maintained with sensible defaults

### External Supabase Support
- New --ext-supabase PATH flag to use existing Supabase installations
- Dual-mode operation: internal (original) vs external Supabase
- Safety checks to prevent conflicts between internal/external modes
- Smart output filtering with orphan warning suppression for external mode
- Quiet mode for cleaner Docker Compose output in external mode

### Enhanced Script Functionality
- Improved start_services.py with better error handling and user guidance
- Safety warnings when switching between internal/external modes
- Clean separation of concerns with dedicated functions for each mode
- Enhanced logging with selective verbosity control

### Documentation
- Comprehensive CLAUDE.md with architecture overview and development commands
- Port configuration guidance and troubleshooting information
- Clear explanation of dual-mode operation and use cases

## Benefits
- Easy port conflict resolution through centralized configuration
- Flexible deployment options for users with existing Supabase instances
- Improved developer experience with better documentation and tooling
- Cleaner output and reduced noise in external Supabase mode
- Maintains full backward compatibility for existing users

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Keep port parameterization changes in all files
- Preserve external Supabase functionality in start_services.py
- Maintain enhanced Caddyfile with environment variable support
- Add SearXNG troubleshooting note from upstream
- Resolve whitespace and formatting conflicts

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@tazmon95 tazmon95 marked this pull request as ready for review July 29, 2025 02:36
…tures

- Document --ext-supabase flag usage and requirements
- Explain benefits of external Supabase mode
- Add port parameterization configuration section
- Include examples and best practices

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants