{
  "schemaVersion": "1.0",
  "canonical": "https://superlumin.al/docs/blender-addon/install-and-connect",
  "representations": {
    "html": "https://superlumin.al/docs/blender-addon/install-and-connect",
    "markdown": "https://superlumin.al/docs/blender-addon/install-and-connect.md",
    "json": "https://superlumin.al/docs/blender-addon/install-and-connect.json"
  },
  "retrievalHint": "Read page.description and page.relatedArticles first, then page.body. page.images lists every documentation screenshot with alt text, dimensions, captions, and annotations.",
  "page": {
    "path": "/docs/blender-addon/install-and-connect",
    "title": "Install and connect",
    "description": "Install or update the Superluminal Blender add-on, then connect it to the correct account and organization.",
    "section": "Blender add-on",
    "sectionOrder": 20,
    "order": 2,
    "hidden": false,
    "keywords": [
      "install Blender addon",
      "connect account",
      "sign in"
    ],
    "updated": "2026-08-04",
    "body": "The add-on installs like any other Blender add-on and authenticates through your browser, so no credentials pass through Blender itself. This page covers installing, connecting, updating, and what to check when the connection fails.\n\n## Install the add-on\n\n![Blender Preferences on the Add-ons section with the Superluminal add-on installed and enabled](https://superlumin.al/docs/images/blender/addon-install.png)\n\n*Blender's Preferences with the add-on installed: search finds it, the header menu holds Install from Disk, and the checkbox enables it.*\n\n- [Annotation 1: Search installed add-ons](/docs/blender-addon/install-and-connect#install-the-add-on)\n\n- [Annotation 2: Install from Disk lives in this menu](/docs/blender-addon/install-and-connect#install-the-add-on)\n\n- [Annotation 3: Enable the add-on after installing](/docs/blender-addon/install-and-connect#install-the-add-on)\n\n### Download the release ZIP\n\nGet the current release from [superlumin.al/blender-addon](https://superlumin.al/blender-addon). The page resolves the latest published GitHub release.\n\n### Open Blender preferences\n\nChoose **Edit → Preferences → Add-ons**. On Blender versions that show extension controls differently, use the add-on menu's **Install from Disk** action.\n\n### Select the ZIP\n\nInstall the downloaded archive directly. Do not extract it first.\n\n### Enable the add-on\n\nEnable **Superluminal Render Farm** if Blender does not enable it automatically.\n\n### Find the panel\n\nOpen **Render Properties** and expand **Superluminal Render**.\n\n### Supported remote versions\n\nThe current add-on can target Blender 4.0 through 5.2. The farm selects its build by major and minor version, not by your exact patch number.\n\n### The current add-on requires Blender 4.4 or newer\n\nLocal add-on compatibility and remote farm selection are different: install and run this add-on in Blender 4.4+, even though its farm-version picker can target Blender 4.0 through 5.2.\n\n## Connect to Superluminal\n\nThe preferred flow keeps credentials out of the Blender form:\n\n![The Superluminal Render panel before sign-in with the Connect to Superluminal button](https://superlumin.al/docs/images/blender/addon-connect.png)\n\n*Connect through the browser first. Password sign-in remains a collapsed fallback.*\n\n- [Annotation 1: Open the browser sign-in flow](/docs/blender-addon/install-and-connect#connect-to-superluminal)\n\n- [Annotation 2: Password sign-in fallback](/docs/blender-addon/install-and-connect#if-connection-fails)\n\n1. Click **Connect to Superluminal**.\n2. Sign in or confirm the request in the opened browser.\n3. Return to Blender and wait for the connected state.\n4. Select a project, or create one in the web app and refresh.\n\nThe collapsed password form is a fallback for when the browser connection cannot complete. The add-on keeps the password in memory only and does not store it.\n\n### Use the intended organization\n\nProjects and render credits are organization-scoped. After connecting, confirm that the expected project is visible before submitting billable work.\n\n## Update safely\n\n1. Let running submission or download terminals finish first.\n2. Download the current release ZIP.\n3. Install it over the existing add-on using **Install from Disk**.\n4. Restart Blender if the UI or operators still reflect the previous release.\n5. Open the panel, verify the connection, and run a one-frame test before a deadline-critical job.\n\n## If connection fails\n\n- Confirm the browser finished the authorization flow rather than only opening the site.\n- Return to Blender and wait a moment for the result.\n- Reopen **Superluminal Render** and retry the connection.\n- Use password sign-in only as the fallback.\n- Do not send passwords, access tokens, or a session file to support.\n\n- [Submit a job](/docs/blender-addon/job-submission): Configure a representative still or an animation range.\n- [Connection troubleshooting](/docs/blender-addon/troubleshooting#connection-and-projects): Collect safe diagnostics when authentication or projects fail to load.",
    "images": [
      {
        "id": "addon-install",
        "src": "/docs/images/blender/addon-install.png",
        "alt": "Blender Preferences on the Add-ons section with the Superluminal add-on installed and enabled",
        "caption": "Blender's Preferences with the add-on installed: search finds it, the header menu holds Install from Disk, and the checkbox enables it.",
        "width": 1440,
        "height": 1020,
        "annotations": [
          {
            "number": 1,
            "label": "Search installed add-ons",
            "href": "/docs/blender-addon/install-and-connect#install-the-add-on"
          },
          {
            "number": 2,
            "label": "Install from Disk lives in this menu",
            "href": "/docs/blender-addon/install-and-connect#install-the-add-on"
          },
          {
            "number": 3,
            "label": "Enable the add-on after installing",
            "href": "/docs/blender-addon/install-and-connect#install-the-add-on"
          }
        ]
      },
      {
        "id": "addon-connect",
        "src": "/docs/images/blender/addon-connect.png",
        "alt": "The Superluminal Render panel before sign-in with the Connect to Superluminal button",
        "caption": "Connect through the browser first. Password sign-in remains a collapsed fallback.",
        "width": 1440,
        "height": 500,
        "annotations": [
          {
            "number": 1,
            "label": "Open the browser sign-in flow",
            "href": "/docs/blender-addon/install-and-connect#connect-to-superluminal"
          },
          {
            "number": 2,
            "label": "Password sign-in fallback",
            "href": "/docs/blender-addon/install-and-connect#if-connection-fails"
          }
        ]
      }
    ],
    "machineReadable": {
      "markdown": "/docs/blender-addon/install-and-connect.md",
      "json": "/docs/blender-addon/install-and-connect.json"
    },
    "internalLinks": [
      "/docs/blender-addon/install-and-connect",
      "/docs/blender-addon/install-and-connect",
      "/docs/blender-addon/install-and-connect",
      "/docs/blender-addon/install-and-connect",
      "/docs/blender-addon/install-and-connect",
      "/docs/blender-addon/job-submission",
      "/docs/blender-addon/troubleshooting"
    ],
    "readingTime": "3 min read",
    "toc": [
      {
        "id": "install-the-add-on",
        "title": "Install the add-on",
        "level": 2
      },
      {
        "id": "download-the-release-zip",
        "title": "Download the release ZIP",
        "level": 3
      },
      {
        "id": "open-blender-preferences",
        "title": "Open Blender preferences",
        "level": 3
      },
      {
        "id": "select-the-zip",
        "title": "Select the ZIP",
        "level": 3
      },
      {
        "id": "enable-the-add-on",
        "title": "Enable the add-on",
        "level": 3
      },
      {
        "id": "find-the-panel",
        "title": "Find the panel",
        "level": 3
      },
      {
        "id": "supported-remote-versions",
        "title": "Supported remote versions",
        "level": 3
      },
      {
        "id": "the-current-add-on-requires-blender-44-or-newer",
        "title": "The current add-on requires Blender 4.4 or newer",
        "level": 3
      },
      {
        "id": "connect-to-superluminal",
        "title": "Connect to Superluminal",
        "level": 2
      },
      {
        "id": "use-the-intended-organization",
        "title": "Use the intended organization",
        "level": 3
      },
      {
        "id": "update-safely",
        "title": "Update safely",
        "level": 2
      },
      {
        "id": "if-connection-fails",
        "title": "If connection fails",
        "level": 2
      }
    ],
    "wordCount": 584,
    "relatedArticles": [
      {
        "path": "/interface",
        "title": "The Superluminal render interface",
        "description": "A visual tour of Superluminal's Blender add-on, file checks, live job page, previews, and output downloads."
      },
      {
        "path": "/blender-render-farm",
        "title": "Blender render farm",
        "description": "A Blender render farm assigns animation frames to many computers. Learn how nodes share work, what each node needs, and why submission starts inside Blender."
      }
    ]
  }
}