Merge branch 'next' into bozau/v4.x

Author: Cinzya

.env.example

@@ -0,0 +1,8 @@
+# Site URL for sitemap and meta tags
+# Default: https://coolify.io/docs/
+# For next branch: https://next.coolify.io/docs/
+VITE_SITE_URL=https://coolify.io/docs/
+
+# Analytics domain for Plausible
+# Default: coolify.io/docs
+VITE_ANALYTICS_DOMAIN=coolify.io/docs

.github/workflows/claude-code-review.yml

@@ -0,0 +1,58 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    if: false
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+    
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+            
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+          
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          # claude_args: '--model claude-opus-4-1-20250805 --allowed-tools Bash(gh pr:*)'
+

.github/workflows/production-build.yml

@@ -9,6 +9,7 @@ env:
   GITHUB_REGISTRY: ghcr.io
   IMAGE_NAME: coollabsio/coolify-docs
   VITE_ANALYTICS_DOMAIN: coolify.io/docs
+  VITE_SITE_URL: https://coolify.io/docs/
 
 jobs:
   build:
@@ -50,6 +51,9 @@ jobs:
           context: .
           file: Dockerfile
           platforms: linux/arm64
+          build-args: |
+            VITE_ANALYTICS_DOMAIN=${{ env.VITE_ANALYTICS_DOMAIN }}
+            VITE_SITE_URL=${{ env.VITE_SITE_URL }}
           push: true
           cache-from: type=gha,scope=${{ github.workflow }}
           cache-to: type=gha,mode=max,scope=${{ github.workflow }}

.github/workflows/staging-build.yml

@@ -8,6 +8,8 @@ on:
 env:
   GITHUB_REGISTRY: ghcr.io
   IMAGE_NAME: coollabsio/coolify-docs
+  VITE_ANALYTICS_DOMAIN: next.coolify.io/docs
+  VITE_SITE_URL: https://next.coolify.io/docs/
 
 jobs:
   build:
@@ -50,7 +52,8 @@ jobs:
           file: Dockerfile
           platforms: linux/arm64
           build-args: |
-            VITE_ANALYTICS_DOMAIN=next.coolify.io/docs
+            VITE_ANALYTICS_DOMAIN=${{ env.VITE_ANALYTICS_DOMAIN }}
+            VITE_SITE_URL=${{ env.VITE_SITE_URL }}
           push: true
           cache-from: type=gha,scope=${{ github.workflow }}
           cache-to: type=gha,mode=max,scope=${{ github.workflow }}

Dockerfile

@@ -2,7 +2,9 @@
 FROM oven/bun:1.1.44-alpine AS builder
 
 ARG VITE_ANALYTICS_DOMAIN=coolify.io/docs
+ARG VITE_SITE_URL=https://coolify.io/docs/
 ENV VITE_ANALYTICS_DOMAIN=${VITE_ANALYTICS_DOMAIN}
+ENV VITE_SITE_URL=${VITE_SITE_URL}
 RUN apk add --no-cache nodejs npm
 
 # Set working directory and copy necessary files

conductor.json

@@ -0,0 +1,6 @@
+{
+  "scripts": {
+    "run": "bun install && bun run dev"
+  },
+  "runScriptMode": "nonconcurrent"
+}

docs/.vitepress/config.mts

@@ -32,23 +32,30 @@ export default defineConfig({
   lastUpdated: true,
   ignoreDeadLinks: true,
   sitemap: {
-    hostname: 'https://coolify.io/docs/'
+    hostname: env.VITE_SITE_URL ?? 'https://coolify.io/docs/'
+  },
+
+  transformHead: ({ pageData }) => {
+    const canonicalUrl = `${env.VITE_SITE_URL ?? 'https://coolify.io/docs'}${pageData.relativePath.replace(/((^|\/)index)?\.md$/, '$2')}`
+    return [
+      ['link', { rel: 'canonical', href: canonicalUrl }]
+    ]
   },
 
   head: [
     ['meta', { name: 'theme-color', content: '#000000' }],
     ['meta', { property: 'og:type', content: 'website' }],
     ['meta', { property: 'og:title', content: 'Coolify Docs' }],
-    ['meta', { property: 'og:url', content: 'https://coolify.io/docs/' }],
+    ['meta', { property: 'og:url', content: env.VITE_SITE_URL ?? 'https://coolify.io/docs/' }],
     ['meta', { property: 'og:description', content: 'Self hosting with superpowers: An open-source & self-hostable Heroku / Netlify / Vercel alternative.' }],
     ['meta', { property: 'og:image', content: 'https://coolcdn.b-cdn.net/assets/coolify/og-image-docs.png' }],
     ['meta', { property: 'twitter:site', content: '@coolifyio' }],
     ['meta', { property: 'twitter:card', content: 'summary_large_image' }],
     ['meta', { property: 'twitter:title', content: 'Coolify Docs' }],
     ['meta', { property: 'twitter:description', content: 'Self hosting with superpowers: An open-source & self-hostable Heroku / Netlify / Vercel alternative.' }],
-    ['meta', { property: 'twitter:url', content: 'https://coolify.io/docs/' }],
+    ['meta', { property: 'twitter:url', content: env.VITE_SITE_URL ?? 'https://coolify.io/docs/' }],
     ['meta', { property: 'twitter:image', content: 'https://coolcdn.b-cdn.net/assets/coolify/og-image-docs.png' }],
-    ['link', { rel: 'icon', href: '/docs/coolify-logo-transparent.png' }],
+    ['link', { rel: 'icon', href: '/docs/coolify-logo-transparent.png', alt: "Coolify's Logo" }],
     ['link', { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }],
     ['script', { defer: 'true', src: 'https://analytics.coollabs.io/js/script.tagged-events.js', 'data-domain': env.VITE_ANALYTICS_DOMAIN ?? 'coolify.io/docs' }],
     ['script', { async: 'true', src: '/docs/trieve-user-script.js' }],
@@ -177,7 +184,8 @@ export default defineConfig({
         collapsed: true,
         items: [
           { text: 'Introduction', link: '/services/introduction' },
-          { text: 'All Services', link: '/services/overview' }
+          { text: 'All Services', link: '/services/overview' },
+          { text: 'Services Directory', link: '/services/all' }
         ]
       },
       {
@@ -402,6 +410,7 @@ export default defineConfig({
                   },
                 ]
               },
+              { text: 'FAQ', link: '/knowledge-base/faq' },
             ]
           }
         ],
@@ -439,6 +448,7 @@ export default defineConfig({
             collapsed: true,
             items: [
               { text: 'Bad Gateway (502)', link: '/troubleshoot/applications/bad-gateway.md' },
+              { text: 'No Available Server (503)', link: '/troubleshoot/applications/no-available-server' },
               { text: 'Gateway Timeout (504)', link: '/troubleshoot/applications/gateway-timeout' },
               { text: 'Failed To Get Access Token During Deployment', link: '/troubleshoot/applications/failed-to-get-token' },
             ]