Running Intertia Django with SSR #2263

lewismunene020 · 2025-03-03T13:16:16Z

lewismunene020
Mar 3, 2025

I have recently been exploring inertiajs.

It's pretty good but there isnot enough context on how to run it in ssr mode .

Laravel has the commands for php artisan inertia:start-ssr at the start Command(https://github.com/inertiajs/inertia-laravel/blob/2.x/src/Commands/StartSsr.php) .

I needed to create a similar command for django to start ssr server that can be used for bundling the application ?

How do i get started considering i have already defined the ssr.js file and intertia is working for my django project.

ssr .js

import { createInertiaApp } from "@inertiajs/react";
import createServer from "@inertiajs/react/server";
import { createRoot } from "react-dom/client";
import "vite/modulepreload-polyfill";
import "./index.css";
import ReactDOMServer from "react-dom/server";

// document.addEventListener("DOMContentLoaded", () => {
createServer((page) => {
  console.log("server Page ", page);
  return createInertiaApp({
    page,
    render: ReactDOMServer.renderToString,
    resolve: async (name) => {
      console.log("name:", name);

      const pages = import.meta.glob("./pages/**/*.tsx");

      const page = (await pages[`./pages/${name}.tsx`]()).default;
      // page.layout = page.layout || (({ children }) => <>{children}</>); // Ensure layout is defined
      page.layout = page.layout;
      return page; // Return the component
    },
    setup: ({ App, props }) => <App {...props} />,
  });
});
// });

Thank You.

RobertBoes · 2025-03-03T13:57:31Z

RobertBoes
Mar 3, 2025

The inertia:start-ssr command from the Laravel adapter is just a wrapper that takes the output so it'll be logged using Laravel's logs, along with some other helpers. You can run the SSR server without the command by running it with Node/Bun/etc directly, by executing the JS file that Vite generates for the SSR bundle; node bootstrap/ssr/ssr.mjs (that's where it's outputted for Laravel by default)

0 replies

lewismunene020 · 2025-03-03T14:05:19Z

lewismunene020
Mar 3, 2025
Author

Thank You @RobertBoes .

I have seen a svelte example that has helped https://github.com/pmdevita/Django-Svelte-Template.

However I have realised it doesn't update the SEO in the .

Is there a workaround to that ?

Here is the sample code I am using .

import React from 'react'
import { Head } from '@inertiajs/react'
  
  type EventDetailPageProps = {
    event: AppEvent,
    seoData?:SEOData
  }
const Show :React.FC<EventDetailPageProps>  = ({event ,seoData}) => {

  return (
    <div className="container mx-auto p-4">

        {/* seo data */}
        {seoData && (
             <Head>
             <title>{seoData.title}</title>
             <meta name="description" content={seoData.description} />
         </Head>
        )}
       

      <h1 className="text-4xl font-bold">Event: {event.name}</h1>
      <p className="text-lg">Details about the event will go here.</p>
    </div>
  )
}

export default Show

Thank you

2 replies

RobertBoes Mar 3, 2025

I'm not really familiar with how Django works, but it looks like SSR with the Django adapter is either only the HTML hydration (so not head/meta insertion) or you'd need to edit your template.

Looking at this https://github.com/pmdevita/Django-Svelte-Template/blob/master/templates/base.html#L17 it seems to only insert an Inertia block in the body, so the head wouldn't be populated. I do see this in the adapter tho: https://github.com/inertiajs/inertia-django/blob/main/inertia/templates/inertia_ssr.html, so maybe it's just a matter of adding {% block inertia_ssr %}{% endblock %} to the head of your template?

lewismunene020 Mar 3, 2025
Author

Thanks again @RobertBoes .

That really helped I have added this and it's working now .

    {% block inertia_head %}{% for tag in head %}{{tag|safe}}{% endfor %}{% endblock inertia_head %}

I think Django SSR feature is not well documented.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Running Intertia Django with SSR #2263

{{title}}

Replies: 2 comments 2 replies

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

Select a reply

Running Intertia Django with SSR #2263

lewismunene020 Mar 3, 2025

Replies: 2 comments · 2 replies

RobertBoes Mar 3, 2025

lewismunene020 Mar 3, 2025 Author

RobertBoes Mar 3, 2025

lewismunene020 Mar 3, 2025 Author

lewismunene020
Mar 3, 2025

Replies: 2 comments 2 replies

RobertBoes
Mar 3, 2025

lewismunene020
Mar 3, 2025
Author

lewismunene020 Mar 3, 2025
Author