{"id":1,"date":"2026-02-02T18:25:11","date_gmt":"2026-02-02T18:25:11","guid":{"rendered":"https:\/\/eksprt.com\/blog\/?p=1"},"modified":"2026-02-09T13:00:24","modified_gmt":"2026-02-09T13:00:24","slug":"how-to-change-the-public-folder-to-public-html-in-laravel","status":"publish","type":"post","link":"https:\/\/eksprt.com\/blog\/how-to-change-the-public-folder-to-public-html-in-laravel\/","title":{"rendered":"How to Change the public Folder to public_html in Laravel (Step-by-Step Guide)"},"content":{"rendered":"\r\n

If you are deploying Laravel on shared hosting like Hostinger<\/a> or cPanel servers<\/strong>, you may notice that the document root is public_html<\/code> instead of Laravel\u2019s default public<\/code> directory. This mismatch can cause asset loading issues, broken storage links, or security concerns if not handled correctly.<\/p>\r\n\r\n\r\n\r\n

<\/p>\r\n\r\n\r\n\r\n

In this expert Laravel tutorial<\/strong>, you will learn how to change the Laravel public folder to public_html<\/code> safely<\/strong>, including support for Vite, storage symlinks, and Hot Module Replacement (HMR)<\/strong>.<\/p>\r\n\r\n\r\n\r\n

<\/p>\r\n\r\n\r\n\r\n

\r\n\r\n\r\n\r\n

Why Change Laravel\u2019s Public Folder to public_html<\/code>?<\/h2>\r\n\r\n\r\n\r\n

Many hosting providers enforce public_html<\/code> as the web root. Common reasons to change it include:<\/p>\r\n\r\n\r\n\r\n

    \r\n
  • Compatibility with cPanel \/ shared hosting<\/strong><\/li>\r\n\r\n\r\n\r\n
  • Avoiding unnecessary symlinks<\/li>\r\n\r\n\r\n\r\n
  • Improved application security<\/strong><\/li>\r\n\r\n\r\n\r\n
  • Cleaner project structure<\/li>\r\n\r\n\r\n\r\n
  • Proper Vite asset resolution<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
    \r\n

    \u2705 This method works for Laravel 9, Laravel 10, and newer versions<\/strong><\/p>\r\n<\/blockquote>\r\n\r\n\r\n\r\n

    \r\n\r\n\r\n\r\n

    Prerequisites<\/h2>\r\n\r\n\r\n\r\n

    Before proceeding, ensure you have:<\/p>\r\n\r\n\r\n\r\n

      \r\n
    • Laravel 9+<\/li>\r\n\r\n\r\n\r\n
    • PHP 8 or higher<\/li>\r\n\r\n\r\n\r\n
    • Node.js (for Vite)<\/li>\r\n\r\n\r\n\r\n
    • Access to project files (SSH or FTP)<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
      \r\n\r\n\r\n\r\n

      Step 1: Override the Public Path in AppServiceProvider<\/code><\/h2>\r\n\r\n\r\n\r\n

      Laravel internally resolves the public directory using the service container. We override it to point to public_html<\/code>.<\/p>\r\n\r\n\r\n\r\n

      \ud83d\udccd File:<\/strong> app\/Providers\/AppServiceProvider.php<\/code><\/p>\r\n\r\n\r\n\r\n

      <\/pre>\r\n\r\n\r\n\r\n
      \/**\r\n * Overwrite public folder.\r\n *\/\r\n$this->app->bind('path.public', function () {\r\n    return base_path('public_html');\r\n});\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
      Why This Is Important<\/h3>\r\n\r\n\r\n\r\n
        \r\n
      • Updates public_path()<\/code> globally<\/li>\r\n\r\n\r\n\r\n
      • Ensures asset helpers reference public_html<\/code><\/li>\r\n\r\n\r\n\r\n
      • Prevents broken file paths in production<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
        \r\n\r\n\r\n\r\n
        Step 2: Configure the Public Path in bootstrap\/app.php<\/code><\/h2>\r\n\r\n\r\n\r\n
        Modern Laravel versions define the public path during application bootstrapping.<\/p>\r\n\r\n\r\n\r\n
        \ud83d\udccd File:<\/strong> bootstrap\/app.php<\/code><\/p>\r\n\r\n\r\n\r\n
        <\/pre>\r\n\r\n\r\n\r\n
        <?php\r\n\r\nuse Illuminate\\Foundation\\Application;\r\nuse Illuminate\\Foundation\\Configuration\\Exceptions;\r\nuse Illuminate\\Foundation\\Configuration\\Middleware;\r\n\r\n$app = Application::configure(basePath: dirname(__DIR__))\r\n    ->withRouting(\r\n        web: __DIR__.'\/..\/routes\/web.php',\r\n        commands: __DIR__.'\/..\/routes\/console.php',\r\n        health: '\/up',\r\n    )\r\n    ->withMiddleware(function (Middleware $middleware) {\r\n        $middleware->validateCsrfTokens(except: [\r\n            '\/admin\/upload',\r\n        ]);\r\n    })\r\n    ->withExceptions(function (Exceptions $exceptions) {\r\n        \/\/\r\n    })\r\n    ->registered(function ($app) {\r\n        $app->usePublicPath(\r\n            path: realpath(base_path('\/..\/public_html'))\r\n        );\r\n    })\r\n    ->create();\r\n\r\n$app->bind('path.public', function () {\r\n    return base_path().'\/public_html';\r\n});\r\n\r\nreturn $app;\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
        SEO Benefit<\/h3>\r\n\r\n\r\n\r\n
        Ensures:<\/p>\r\n\r\n\r\n\r\n
          \r\n
        • Proper asset loading<\/li>\r\n\r\n\r\n\r\n
        • No broken CSS or JS files<\/li>\r\n\r\n\r\n\r\n
        • Faster page rendering (Core Web Vitals)<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
          \r\n\r\n\r\n\r\n
          Step 3: Fix Storage Symlinks (storage:link<\/code>)<\/h2>\r\n\r\n\r\n\r\n
          Laravel\u2019s file uploads rely on the public directory. Update the symlink configuration accordingly.<\/p>\r\n\r\n\r\n\r\n
          \ud83d\udccd File:<\/strong> config\/filesystems.php<\/code><\/p>\r\n\r\n\r\n\r\n
          <\/pre>\r\n\r\n\r\n\r\n
          'links' => [\r\n    app()->basePath('public_html\/storage') => storage_path('app\/public'),\r\n],\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
          Then run:<\/p>\r\n\r\n\r\n\r\n
          <\/pre>\r\n\r\n\r\n\r\n
          php artisan storage:link\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
          Result<\/h3>\r\n\r\n\r\n\r\n
          Uploads will now be accessible at:<\/p>\r\n\r\n\r\n\r\n
          <\/pre>\r\n\r\n\r\n\r\n
          \/public_html\/storage\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
          \r\n\r\n\r\n\r\n
          Step 4: Update Vite Configuration for public_html<\/code><\/h2>\r\n\r\n\r\n\r\n
          Vite must be aware of the new public directory for Hot Module Replacement (HMR)<\/strong> and production builds.<\/p>\r\n\r\n\r\n\r\n
          \ud83d\udccd File:<\/strong> vite.config.js<\/code><\/p>\r\n\r\n\r\n\r\n
          <\/pre>\r\n\r\n\r\n\r\n
          import { defineConfig } from 'vite';\r\nimport laravel from 'laravel-vite-plugin';\r\n\r\nexport default defineConfig({\r\n    plugins: [\r\n        laravel({\r\n            input: ['resources\/js\/app.js'],\r\n            publicDirectory: 'public_html',\r\n        }),\r\n    ],\r\n    build: {\r\n        outDir: 'public_html\/build',\r\n    },\r\n    server: {\r\n        hmr: {\r\n            host: 'localhost',\r\n        },\r\n    },\r\n});\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
          Why This Matters for SEO<\/h3>\r\n\r\n\r\n\r\n
            \r\n
          • Prevents broken assets<\/li>\r\n\r\n\r\n\r\n
          • Improves Lighthouse performance scores<\/li>\r\n\r\n\r\n\r\n
          • Ensures proper asset versioning<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
            \r\n\r\n\r\n\r\n
            Step 5: Rename the Public Folder<\/h2>\r\n\r\n\r\n\r\n
            Rename Laravel\u2019s default public directory:<\/p>\r\n\r\n\r\n\r\n
            <\/pre>\r\n\r\n\r\n\r\n
            mv public public_html\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
            Make sure your server document root<\/strong> points to:<\/p>\r\n\r\n\r\n\r\n
            <\/pre>\r\n\r\n\r\n\r\n
            \/your-project\/public_html\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
            \r\n\r\n\r\n\r\n
            Clear Cache and Rebuild Assets<\/h2>\r\n\r\n\r\n\r\n
            After all changes, run:<\/p>\r\n\r\n\r\n\r\n
            <\/pre>\r\n\r\n\r\n\r\n
            php artisan optimize:clear\r\nnpm run build\r\n<\/code><\/pre>\r\n\r\n\r\n\r\n
            This ensures:<\/p>\r\n\r\n\r\n\r\n
              \r\n
            • Fresh configuration<\/li>\r\n\r\n\r\n\r\n
            • Clean route & view caches<\/li>\r\n\r\n\r\n\r\n
            • Correct asset compilation<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
              \r\n\r\n\r\n\r\n
              Common Issues and Fixes<\/h2>\r\n\r\n\r\n\r\n
              Problem<\/th>Solution<\/th><\/tr><\/thead>
              Assets not loading<\/td>Rebuild Vite assets<\/td><\/tr>
              Storage files 404<\/td>Re-run storage:link<\/code><\/td><\/tr>
              HMR not working<\/td>Set correct HMR host<\/td><\/tr>
              Cached paths<\/td>Run optimize:clear<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\r\n\r\n\r\n\r\n
              \r\n\r\n\r\n\r\n
              Final Thoughts<\/h2>\r\n\r\n\r\n\r\n
              Changing Laravel\u2019s public<\/code> folder to public_html<\/code> is 100% safe and production-ready<\/strong> when configured properly. This setup is ideal for:<\/p>\r\n\r\n\r\n\r\n
                \r\n
              • Shared hosting<\/li>\r\n\r\n\r\n\r\n
              • cPanel environments<\/li>\r\n\r\n\r\n\r\n
              • Secure Laravel deployments<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
                By updating Laravel\u2019s service container, bootstrap configuration, filesystem links, and Vite settings<\/strong>, you ensure long-term stability and SEO-friendly asset delivery.<\/p>\r\n\r\n\r\n\r\n
                <\/p>\r\n","protected":false},"excerpt":{"rendered":"
                If you are deploying Laravel on shared hosting like Hostinger or cPanel servers, you may notice that the document root is public_html instead of Laravel\u2019s default public directory. This mismatch can cause asset loading issues, broken storage links, or security concerns if not handled correctly. In this expert Laravel tutorial, you will learn how to […]<\/p>\n","protected":false},"author":1,"featured_media":7380,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/posts\/1","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/comments?post=1"}],"version-history":[{"count":1,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/posts\/1\/revisions"}],"predecessor-version":[{"id":7376,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/posts\/1\/revisions\/7376"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/media\/7380"}],"wp:attachment":[{"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/media?parent=1"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/categories?post=1"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/eksprt.com\/blog\/wp-json\/wp\/v2\/tags?post=1"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}