> For the complete documentation index, see [llms.txt](https://help.movin3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.movin3d.com/movin-tracin-stage/reference/update-guide.md).

# Update guide

Everything is in the one file you download — no git, no compiler, no administrator password. It is three short steps, and one of them is just restarting the computer.

**This guide belongs to one specific update file:**

|          |                                                                                                    |
| -------- | -------------------------------------------------------------------------------------------------- |
| File     | `mlb-update-8d6aab9-20260811.tar.gz` (24 MB)                                                       |
| Download | [Google Drive](https://drive.google.com/file/d/1__DEhbipGOLwGwIUm0IDKaYHP9_e-hVw/view?usp=sharing) |

If the file you were sent has a different name, ask us for the matching guide.

## Before you start

* If the system is running, press **Stop pipeline** in the GUI. No such button means nothing is running, so there is nothing to stop.
* Never put `sudo` in front of these commands. Nothing here asks for a password — if something does, stop and tell us.

## Get the machine online

The show machine normally runs without internet. Plug an internet cable into the port marked **INTERNET** in [The back of the server](/movin-tracin-stage/install-the-hardware/server-back.md) — the LAN port on the motherboard. If the machine is set up with manual IPs, use the **left** motherboard port.

If pages still do not load a minute later:

1. Click the top-right corner of the screen → **Wired** → **Wired Settings**.
2. Select the gear (⚙) next to **Realtek Ethernet**.
3. In the **IPv4** tab, choose **Automatic (DHCP)** → **Apply**, then switch that connection off and on again.

<figure><img src="/files/KVRTKKk0kCLwPPO5haVp" alt="The top-right menu with Wired highlighted"><figcaption><p>Step 1 — click the top-right corner, then select <strong>Wired</strong>.</p></figcaption></figure>

<figure><img src="/files/1LgpR4vCHjdmUmntEZvX" alt="Wired Connections with Wired Settings highlighted"><figcaption><p>Step 1 — then select <strong>Wired Settings</strong>.</p></figcaption></figure>

<figure><img src="/files/dQNtr6chnBkla3yta3qT" alt="The Network page with the Realtek Ethernet gear highlighted"><figcaption><p>Step 2 — the gear next to <strong>Realtek Ethernet</strong>. Leave the other two alone.</p></figcaption></figure>

<figure><img src="/files/d5weONLdSU9J26g9oAfw" alt="The IPv4 tab with Automatic (DHCP) and Apply highlighted"><figcaption><p>Step 3 — <strong>IPv4</strong> tab → <strong>Automatic (DHCP)</strong> → <strong>Apply</strong>.</p></figcaption></figure>

{% hint style="warning" %}
**Only touch Realtek Ethernet.** The other network devices belong to the sensors — changing those can take the show down.
{% endhint %}

## Install it (\~15 minutes)

**1.** Download the update file:

{% hint style="info" %}

### [Download `mlb-update-8d6aab9-20260811.tar.gz` (24 MB)](https://drive.google.com/file/d/1__DEhbipGOLwGwIUm0IDKaYHP9_e-hVw/view?usp=sharing)

On the Google Drive page, use the **Download** button at the top right.
{% endhint %}

Then open a terminal and run:

```bash
cd ~/Downloads
tar -xzf mlb-update-8d6aab9-20260811.tar.gz
cd mlb-update-8d6aab9-20260811
bash apply_update.sh --apply --no-restart
```

It prints a short report and asks — type `y`. (If a line warns about `glibc`, answer `n` and tell us instead.) It backs everything up first and prints the backup path — **write that path down, it is your undo button.**

**2.** Restart the computer. Until you do, the machine is still running the old version.

**3.** After it boots, the show screen comes up on its own. That is the whole update — the machine is now on the new version.

Your settings, calibrations, and zones are never touched by the update.

### If something is wrong — undo

```bash
cd ~/Downloads/mlb-update-8d6aab9-20260811
bash apply_update.sh --rollback <the backup path you wrote down> --no-restart
```

Then restart the computer again.

## Send us your calibration files (\~5 minutes)

Safe to run any time.

```bash
cd ~/Downloads/mlb-update-8d6aab9-20260811
python3 collect_site_data.py --collect
```

It writes one file into **Home → mlb-collect** (`/home/movin/mlb-collect/`). Send us that file, any way that suits you.

## If you get stuck

| What you see                                                  | What to do                                                         |
| ------------------------------------------------------------- | ------------------------------------------------------------------ |
| Any password prompt                                           | Stop — that command was not from this guide. Tell us what you ran. |
| `checksum mismatch — the bundle did not survive the transfer` | The download broke. Download it again.                             |
| `the pipeline is running (N processes)`                       | Press **Stop pipeline** in the GUI, then run the command again.    |
| `... need GLIBC_2.34 but this host has ...`                   | Stop and tell us. Do not use `--force`.                            |
| `Permission denied` while installing                          | Stop and tell us — do not retry with `sudo`.                       |
| Screen looks unchanged after the restart                      | Press Ctrl+Shift+R on the show screen. Still unchanged? Tell us.   |
| The screen does not come back                                 | Give it two minutes, then tell us. Your backup is untouched.       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.movin3d.com/movin-tracin-stage/reference/update-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.