Skip to content

fix: enhance docker build CI pipeline, update docker ports, docs & new documents UI#866

Merged
MODSetter merged 37 commits intoMODSetter:devfrom
AnishSarkar22:fix/docker-dev
Mar 10, 2026
Merged

fix: enhance docker build CI pipeline, update docker ports, docs & new documents UI#866
MODSetter merged 37 commits intoMODSetter:devfrom
AnishSarkar22:fix/docker-dev

Conversation

@AnishSarkar22
Copy link
Contributor

@AnishSarkar22 AnishSarkar22 commented Mar 9, 2026

Description

  • Added conditional execution to tag_release (only on default branch / manual dispatch), build (runs even when tagging is skipped), and create_manifest (runs as long as build succeeds) — enabling the workflow to build images for non-default branches like dev. Added null-safety for version tag computation, guarded version-based Docker tags with enable conditions to prevent empty tags, and introduced a new type=sha,prefix=git- tag so every build is traceable to its exact commit. The workflow uses docker buildx for multi-platform image builds (linux/amd64, linux/arm64) and manifest creation.
  • Now we are using different ports for Docker Compose production setup. Frontend uses 3929, backend uses 8929, electric uses 5929 by default.
  • Updated docker docs.
  • Many UI/UX improvements.
  • New document UI for desktop view.

Motivation and Context

FIX #

Screenshots

API Changes

  • This PR includes API changes

Change Type

  • Bug fix
  • New feature
  • Performance improvement
  • Refactoring
  • Documentation
  • Dependency/Build system
  • Breaking change
  • Other (specify):

Testing Performed

  • Tested locally
  • Manual/QA verification

Checklist

  • Follows project coding standards and conventions
  • Documentation updated as needed
  • Dependencies updated as needed
  • No lint/build errors or new warnings
  • All relevant tests are passing

High-level PR Summary

This PR updates the default Docker ports for SurfSense to avoid conflicts with other services. The frontend now uses port 3929 (previously 3000), backend uses 8929 (previously 8000), and Electric SQL uses 5929 (previously 5133). The documentation has been reorganized into separate pages under a new docker-installation section, splitting the single Docker installation guide into dedicated pages for the install script, Docker Compose setup, updating, and development compose. All connector documentation and install scripts have been updated to reference the new port numbers and documentation structure.

⏱️ Estimated Review Time: 30-90 minutes

💡 Review Order Suggestion
Order File Path
1 docker/.env.example
2 docker/docker-compose.yml
3 docker/docker-compose.dev.yml
4 docker/scripts/install.sh
5 docker/scripts/install.ps1
6 surfsense_web/content/docs/docker-installation/install-script.mdx
7 surfsense_web/content/docs/docker-installation/docker-compose.mdx
8 surfsense_web/content/docs/docker-installation/updating.mdx
9 surfsense_web/content/docs/docker-installation/dev-compose.mdx
10 surfsense_web/content/docs/docker-installation/meta.json
11 surfsense_web/content/docs/docker-installation/migrate-from-allinone.mdx
12 surfsense_web/content/docs/how-to/electric-sql.mdx
13 surfsense_web/content/docs/how-to/meta.json
14 surfsense_web/content/docs/installation.mdx
15 surfsense_web/app/sitemap.ts
16 surfsense_web/content/docs/connectors/airtable.mdx
17 surfsense_web/content/docs/connectors/clickup.mdx
18 surfsense_web/content/docs/connectors/confluence.mdx
19 surfsense_web/content/docs/connectors/discord.mdx
20 surfsense_web/content/docs/connectors/gmail.mdx
21 surfsense_web/content/docs/connectors/google-calendar.mdx
22 surfsense_web/content/docs/connectors/google-drive.mdx
23 surfsense_web/content/docs/connectors/jira.mdx
24 surfsense_web/content/docs/connectors/linear.mdx
25 surfsense_web/content/docs/connectors/microsoft-teams.mdx
26 surfsense_web/content/docs/connectors/notion.mdx
27 surfsense_web/content/docs/connectors/slack.mdx
28 .dockerignore
29 .github/workflows/docker_build.yaml
⚠️ Inconsistent Changes Detected
File Path Warning
.dockerignore Removing the entire .dockerignore file in a PR focused on port changes and documentation updates seems unrelated to the stated purpose
.github/workflows/docker_build.yaml Extensive CI/CD workflow changes including digest uploads, manifest creation logic, and conditional job execution are not mentioned in the PR description and appear unrelated to port/documentation updates

Need help? Join our Discord

Analyzing latest changes...

… job execution and integrating Docker metadata action for improved tagging and manifest creation
…and improve tagging logic for better handling of version tags
…ity and consistency in local development environment
@vercel
Copy link

vercel bot commented Mar 9, 2026

@AnishSarkar22 is attempting to deploy a commit to the Rohan Verma's projects Team on Vercel.

A member of the Team first needs to authorize it.

Copy link

@recurseml recurseml bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review by RecurseML

🔍 Review performed on 248d050..609086e

✨ No bugs found, your code is sparkling clean

✅ Files analyzed, no issues (29)

.dockerignore
.github/workflows/docker_build.yaml
docker/.env.example
docker/docker-compose.dev.yml
docker/docker-compose.yml
docker/scripts/install.ps1
docker/scripts/install.sh
surfsense_web/app/sitemap.ts
surfsense_web/content/docs/connectors/airtable.mdx
surfsense_web/content/docs/connectors/clickup.mdx
surfsense_web/content/docs/connectors/confluence.mdx
surfsense_web/content/docs/connectors/discord.mdx
surfsense_web/content/docs/connectors/gmail.mdx
surfsense_web/content/docs/connectors/google-calendar.mdx
surfsense_web/content/docs/connectors/google-drive.mdx
surfsense_web/content/docs/connectors/jira.mdx
surfsense_web/content/docs/connectors/linear.mdx
surfsense_web/content/docs/connectors/microsoft-teams.mdx
surfsense_web/content/docs/connectors/notion.mdx
surfsense_web/content/docs/connectors/slack.mdx
surfsense_web/content/docs/docker-installation.mdx
surfsense_web/content/docs/docker-installation/dev-compose.mdx
surfsense_web/content/docs/docker-installation/docker-compose.mdx
surfsense_web/content/docs/docker-installation/install-script.mdx
surfsense_web/content/docs/docker-installation/meta.json
surfsense_web/content/docs/docker-installation/updating.mdx
surfsense_web/content/docs/how-to/electric-sql.mdx
surfsense_web/content/docs/how-to/meta.json
surfsense_web/content/docs/installation.mdx

⏭️ Files skipped (1)
  Locations  
surfsense_web/content/docs/docker-installation/migrate-from-allinone.mdx

@AnishSarkar22 AnishSarkar22 changed the title fix: docker ports & docker docs fix: enhance docker build CI pipeline, update docker ports & docker docs Mar 9, 2026
Copy link

@recurseml recurseml bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review by RecurseML

🔍 Review performed on 609086e..847564a

✨ No bugs found, your code is sparkling clean

✅ Files analyzed, no issues (10)

surfsense_web/app/layout.config.tsx
surfsense_web/app/sitemap.ts
surfsense_web/content/docs/code-of-conduct.mdx
surfsense_web/content/docs/docker-installation/dev-compose.mdx
surfsense_web/content/docs/docker-installation/install-script.mdx
surfsense_web/content/docs/docker-installation/migrate-from-allinone.mdx
surfsense_web/content/docs/how-to/meta.json
surfsense_web/content/docs/index.mdx
surfsense_web/content/docs/meta.json
surfsense_web/content/docs/prerequisites.mdx

…increase initial page size in use-documents hook
…ality; enhance LayoutDataProvider and LayoutShell to support new state management
…ine comment panel styling for improved responsiveness
…change from 480px to 380px in both docked and mobile views
…tarGroup component for better UI representation
…ce Popover with DropdownMenu for improved user experience
…management and connector integration; replace Cable icon with Unplug for better clarity
…DataProvider; enhance DropdownMenu in ComposerAction with separator for improved UI clarity
…e GitHub stars badge with particle effects for improved visual feedback
…integration and user engagement; update SidebarSlideOutPanel to conditionally render backdrop overlay based on mobile view
@AnishSarkar22 AnishSarkar22 marked this pull request as ready for review March 10, 2026 10:47
@AnishSarkar22 AnishSarkar22 marked this pull request as draft March 10, 2026 19:40
…urces and Report; update report panel handling in dashboard chat page for improved user experience
… width adjustments; refactor ReportPanelContent to streamline loading state handling
…ges; implement version tagging and multi-platform support for backend and web services
…mations and layout handling; integrate motion effects for smoother transitions
…r components; adjust sidebar behavior based on device type and improve right panel handling
@AnishSarkar22 AnishSarkar22 marked this pull request as ready for review March 10, 2026 20:49
@MODSetter MODSetter merged commit d41d1a1 into MODSetter:dev Mar 10, 2026
13 of 17 checks passed
@AnishSarkar22 AnishSarkar22 changed the title fix: enhance docker build CI pipeline, update docker ports & docker docs fix: enhance docker build CI pipeline, update docker ports, docs & new documents UI Mar 10, 2026
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