[{"data":1,"prerenderedAt":458},["ShallowReactive",2],{"docs-nav:docs_en":3,"docs-page:\u002Fen\u002Fdocs\u002Fconcepts\u002Fworkspace":158,"docs-surround:\u002Fen\u002Fdocs\u002Fconcepts\u002Fworkspace":453},[4],{"title":5,"path":6,"stem":7,"children":8,"page":74},"En","\u002Fen","en",[9],{"title":10,"path":11,"stem":12,"children":13,"page":74},"Docs","\u002Fen\u002Fdocs","en\u002Fdocs",[14,75,134],{"title":15,"icon":16,"path":17,"stem":18,"children":19,"page":74},"Guides","i-lucide-book-open","\u002Fen\u002Fdocs\u002Fguides","en\u002Fdocs\u002F1.guides",[20,25,30,35,40,44,49,54,59,64,69],{"title":21,"path":22,"stem":23,"icon":24},"Introduction","\u002Fen\u002Fdocs\u002Fguides\u002Fintroduction","en\u002Fdocs\u002F1.guides\u002F01.introduction","i-lucide-info",{"title":26,"path":27,"stem":28,"icon":29},"Quick start","\u002Fen\u002Fdocs\u002Fguides\u002Fquick-start","en\u002Fdocs\u002F1.guides\u002F02.quick-start","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Add the office computers","\u002Fen\u002Fdocs\u002Fguides\u002Foffice","en\u002Fdocs\u002F1.guides\u002F03.office","i-lucide-building-2",{"title":36,"path":37,"stem":38,"icon":39},"Rendering on GPU Rental Platforms","\u002Fen\u002Fdocs\u002Fguides\u002Fcloud","en\u002Fdocs\u002F1.guides\u002F04.cloud","i-lucide-cloud",{"title":41,"path":42,"stem":43},"Configuring Cloudflare R2 Storage","\u002Fen\u002Fdocs\u002Fguides\u002Fr2","en\u002Fdocs\u002F1.guides\u002F05.r2",{"title":45,"path":46,"stem":47,"icon":48},"Run the host on a NAS","\u002Fen\u002Fdocs\u002Fguides\u002Fnas","en\u002Fdocs\u002F1.guides\u002F06.nas","i-lucide-hard-drive",{"title":50,"path":51,"stem":52,"icon":53},"Devices in different places","\u002Fen\u002Fdocs\u002Fguides\u002Fremote","en\u002Fdocs\u002F1.guides\u002F07.remote","i-lucide-globe",{"title":55,"path":56,"stem":57,"icon":58},"Get the film","\u002Fen\u002Fdocs\u002Fguides\u002Ffilm","en\u002Fdocs\u002F1.guides\u002F08.film","i-lucide-film",{"title":60,"path":61,"stem":62,"icon":63},"When files change","\u002Fen\u002Fdocs\u002Fguides\u002Fupdate","en\u002Fdocs\u002F1.guides\u002F09.update","i-lucide-refresh-cw",{"title":65,"path":66,"stem":67,"icon":68},"When the host fails or moves","\u002Fen\u002Fdocs\u002Fguides\u002Fhost","en\u002Fdocs\u002F1.guides\u002F10.host","i-lucide-server-cog",{"title":70,"path":71,"stem":72,"icon":73},"FAQ","\u002Fen\u002Fdocs\u002Fguides\u002Ffaq","en\u002Fdocs\u002F1.guides\u002F11.faq","i-lucide-circle-help",false,{"title":76,"icon":77,"path":78,"stem":79,"children":80,"page":74},"Concepts","i-lucide-box","\u002Fen\u002Fdocs\u002Fconcepts","en\u002Fdocs\u002F2.concepts",[81,86,90,95,100,105,109,114,119,124,129],{"title":82,"path":83,"stem":84,"icon":85},"Workspace and host","\u002Fen\u002Fdocs\u002Fconcepts\u002Fworkspace","en\u002Fdocs\u002F2.concepts\u002F01.workspace","i-lucide-network",{"title":87,"path":88,"stem":89,"icon":48},"Store","\u002Fen\u002Fdocs\u002Fconcepts\u002Fstorage","en\u002Fdocs\u002F2.concepts\u002F02.storage",{"title":91,"path":92,"stem":93,"icon":94},"Assets, Unpacking & On-Demand Pull","\u002Fen\u002Fdocs\u002Fconcepts\u002Fassets","en\u002Fdocs\u002F2.concepts\u002F03.assets","i-lucide-images",{"title":96,"path":97,"stem":98,"icon":99},"Projects, tasks and versions","\u002Fen\u002Fdocs\u002Fconcepts\u002Ftasks","en\u002Fdocs\u002F2.concepts\u002F04.tasks","i-lucide-list-checks",{"title":101,"path":102,"stem":103,"icon":104},"Shots and chunks","\u002Fen\u002Fdocs\u002Fconcepts\u002Fshots","en\u002Fdocs\u002F2.concepts\u002F05.shots","i-lucide-clapperboard",{"title":106,"path":107,"stem":108,"icon":58},"Films","\u002Fen\u002Fdocs\u002Fconcepts\u002Ffilm","en\u002Fdocs\u002F2.concepts\u002F06.film",{"title":110,"path":111,"stem":112,"icon":113},"Blender and FFmpeg","\u002Fen\u002Fdocs\u002Fconcepts\u002Fruntimes","en\u002Fdocs\u002F2.concepts\u002F07.runtimes","i-lucide-package",{"title":115,"path":116,"stem":117,"icon":118},"Joining and access","\u002Fen\u002Fdocs\u002Fconcepts\u002Fjoining","en\u002Fdocs\u002F2.concepts\u002F08.joining","i-lucide-key-round",{"title":120,"path":121,"stem":122,"icon":123},"Render seats","\u002Fen\u002Fdocs\u002Fconcepts\u002Fseats","en\u002Fdocs\u002F2.concepts\u002F09.seats","i-lucide-gauge",{"title":125,"path":126,"stem":127,"icon":128},"Backup and takeover","\u002Fen\u002Fdocs\u002Fconcepts\u002Fbackup","en\u002Fdocs\u002F2.concepts\u002F10.backup","i-lucide-life-buoy",{"title":130,"path":131,"stem":132,"icon":133},"Plugins","\u002Fen\u002Fdocs\u002Fconcepts\u002Fplugins","en\u002Fdocs\u002F2.concepts\u002F11.plugins","i-lucide-puzzle",{"title":135,"icon":136,"path":137,"stem":138,"children":139,"page":74},"Reference","i-lucide-library","\u002Fen\u002Fdocs\u002Freference","en\u002Fdocs\u002F3.reference",[140,145,150,154],{"title":141,"path":142,"stem":143,"icon":144},"Command line","\u002Fen\u002Fdocs\u002Freference\u002Fcli","en\u002Fdocs\u002F3.reference\u002F1.cli","i-lucide-terminal",{"title":146,"path":147,"stem":148,"icon":149},"Configuration","\u002Fen\u002Fdocs\u002Freference\u002Fconfig","en\u002Fdocs\u002F3.reference\u002F2.config","i-lucide-sliders",{"title":151,"path":152,"stem":153},"HTTP API","\u002Fen\u002Fdocs\u002Freference\u002Fapi","en\u002Fdocs\u002F3.reference\u002F3.api",{"title":155,"path":156,"stem":157},"Plugin development","\u002Fen\u002Fdocs\u002Freference\u002Fplugins","en\u002Fdocs\u002F3.reference\u002F4.plugins",{"id":159,"title":82,"body":160,"description":447,"extension":448,"meta":449,"navigation":450,"path":83,"seo":451,"stem":84,"__hash__":452},"docs_en\u002Fen\u002Fdocs\u002F2.concepts\u002F01.workspace.md",{"type":161,"value":162,"toc":438},"minimark",[163,168,183,196,211,225,247,250,253,256,293,296,309,312,315,328,349,352,380,394,398,401,409,424,427],[164,165,167],"h2",{"id":166},"workspace","Workspace",[169,170,171,172,177,178,182],"p",{},"A workspace is a group of devices that share a ",[173,174,176],"a",{"href":175},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fstorage#store","store",", ",[173,179,181],{"href":180},"\u002Fen\u002Fdocs\u002Fconcepts\u002Ftasks#projects","projects"," and a queue.",[169,184,185,186,190,191,195],{},"One of them is the ",[173,187,189],{"href":188},"#host","host",", and the other ",[173,192,194],{"href":193},"#devices","devices"," join it. Each project belongs to one workspace, and the project you choose when you submit decides which workspace the task goes to.",[197,198,199,203],"ul",{},[200,201,202],"li",{},"A device can host at most one workspace, but it can join several. For example, an artist's computer can be in both the office workspace and a cloud one.",[200,204,205,206,210],{},"If you only have one computer, create a workspace with ",[207,208,209],"ui",{},"This device"," as the store. That is the single-computer setup.",[169,212,213,214,177,217,220,221,224],{},"The interface shows one workspace at a time. Switch between them on the left of the top bar. The same menu has ",[207,215,216],{},"Workspace details",[207,218,219],{},"Create or take over a workspace…"," and ",[207,222,223],{},"Join a workspace…",".",[169,226,227,229,230,177,233,177,236,177,238,220,241,244,245,224],{},[207,228,216],{}," has several tabs: ",[207,231,232],{},"Overview",[207,234,235],{},"Connection",[207,237,87],{},[207,239,240],{},"Resource pack",[207,242,243],{},"Plugins and integrations",". Only devices with admin access can see ",[207,246,235],{},[164,248,249],{"id":189},"Host",[169,251,252],{},"The host is the device in a workspace that keeps track of projects, tasks and devices, and hands shots out to render machines.",[169,254,255],{},"There is only one host at any time. It is also a device itself, its access is always \"Admin\", and it can render too.",[197,257,258,265,271,282],{},[200,259,260,264],{},[261,262,263],"strong",{},"It must stay on",": render machines get their work from it, and submissions are registered with it. An office computer that is always on, Docker on a NAS or a rented cloud server can all be the host.",[200,266,267,270],{},[261,268,269],{},"The database lives on a local disk",": projects and tasks are recorded in the host's database, and that database must not be on a network share. When you use Docker on a NAS, put the data folder on a local volume of the NAS, not on an SMB mount.",[200,272,273,276,277,279,280,224],{},[261,274,275],{},"Port 7420",": other devices connect to the host on port 7420 by default. Change the port and the external address under ",[207,278,216],{}," → ",[207,281,235],{},[200,283,284,287,288,292],{},[261,285,286],{},"A domain is best",": if devices connect to the host by domain, then when you later ",[173,289,291],{"href":290},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fbackup#changing-hosts","change hosts",", you only change where the domain points, and the devices don't need any change.",[169,294,295],{},"While the host is temporarily offline, render machines finish the chunk they are working on and then wait. Artists can still submit and files still go into the store, but the tasks enter the queue only after the host is back.",[169,297,298,299,303,304,308],{},"The host regularly ",[173,300,302],{"href":301},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fbackup#backups","backs up"," its database to the store. If the host fails, ",[173,305,307],{"href":306},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fbackup#takeover","take over"," on another device.",[164,310,311],{"id":194},"Devices",[169,313,314],{},"A device is one danio that has joined a workspace. The host counts as one too.",[169,316,317,318,322,323,327],{},"Each device has its own ",[173,319,321],{"href":320},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fjoining#access","access",", which decides what it can see and do in the workspace. Whether it renders isn't up to its access. That is decided by its own ",[173,324,326],{"href":325},"#accepting-renders","Render"," switch.",[169,329,330,331,333,334,177,337,340,341,344,345,348],{},"All devices are listed on the ",[207,332,311],{}," page. The top right of each card says ",[207,335,336],{},"Online",[207,338,339],{},"Offline"," or ",[207,342,343],{},"Blocked",", or, while rendering, ",[207,346,347],{},"Rendering"," with the task and frames it is working on.",[169,350,351],{},"Click a card to open the device details:",[197,353,354,362,368,374],{},[200,355,356,358,359,224],{},[207,357,232],{},": state, hardware, why it can't render, and ",[207,360,361],{},"Access and rendering",[200,363,364,367],{},[207,365,366],{},"Settings",": GPUs, which Blender and FFmpeg to use, cache and work folders, and more. Change this device's settings here. People with admin access can also change other devices remotely, and the device picks up the change within 30 seconds.",[200,369,370,373],{},[207,371,372],{},"Stats",": the chunks this device has rendered, with time, frame counts and traffic.",[200,375,376,379],{},[207,377,378],{},"Activity",": recent warnings, errors and changes. For this device, it also lists the connections to each host.",[169,381,382,383,386,387,389,390,393],{},"For a device you no longer use, first ",[207,384,385],{},"Block"," it at the bottom of ",[207,388,232],{}," in the device details, then hold ",[207,391,392],{},"Remove device",". Use this to clean up the list after you release rented servers.",[164,395,397],{"id":396},"accepting-renders","Accepting renders",[169,399,400],{},"Accepting renders is each device's own switch: while it is on, the device picks up shots to render from every workspace it is in.",[169,402,403,404,279,406,408],{},"The switch is on the right of the top bar, and it is the same switch as the one under ",[207,405,232],{},[207,407,361],{}," in this device's details. People with admin access can also turn it on or off in another device's details.",[197,410,411,414,421],{},[200,412,413],{},"When you create a workspace, the host's switch is turned on, so a single computer can still make films. Once render machines have joined, you can turn the host's switch off.",[200,415,416,417,420],{},"Devices that join with a command created by ",[207,418,419],{},"Add device"," have it on by default.",[200,422,423],{},"Devices that join over the local network have it off by default, so artists' computers aren't put to rendering when they join.",[169,425,426],{},"When it is off, the device picks up no new chunks. The host is the same: when its switch is off, it doesn't render. There is no \"host steps in when nobody else renders\".",[169,428,429,430,433,434,224],{},"If no device has the switch on, tasks stay at ",[207,431,432],{},"Waiting for a worker",". The number of devices rendering at the same time is limited by ",[173,435,437],{"href":436},"\u002Fen\u002Fdocs\u002Fconcepts\u002Fseats#render-seats","render seats",{"title":439,"searchDepth":440,"depth":441,"links":442},"",2,3,[443,444,445,446],{"id":166,"depth":440,"text":167},{"id":189,"depth":440,"text":249},{"id":194,"depth":440,"text":311},{"id":396,"depth":440,"text":397},"Which devices make up a workspace, what the host does, and where to see devices and accepting renders.","md",{},{"icon":85},{"title":82,"description":447},"fCKeQFWl9jQ4jNDs1Y6KhNWUg_RSU6p_r-tAQjyWGXM",[454,456],{"title":70,"path":71,"stem":72,"description":455,"icon":73,"children":-1},"What to do when a task doesn't move, a device waits for a seat, you can't find the workspace or reach the host, the extension isn't enabled, or a task needs attention.",{"title":87,"path":88,"stem":89,"description":457,"icon":48,"children":-1},"Where a workspace's files live, how to choose a store, and caches, storage usage and cleanup.",1794619223480]