# Juice Rebuild or Restart
**URL:** https://community.orangeqs.com/t/juice-rebuild-or-restart/26
**Category:** Q&A
**Created:** [February 24, 2026, 2:57pm UTC](https://community.orangeqs.com/t/juice-rebuild-or-restart/26 "2026-02-24T14:57:22Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@Wiggert](https://community.orangeqs.com/u/Wiggert)
#### Post date: [February 24, 2026, 2:57pm UTC](https://community.orangeqs.com/t/juice-rebuild-or-restart/26/1 "2026-02-24T14:57:22Z")
Hi all,
I was reading through the new Gitlab Auth documentation [here](https://docs.orangeqs.com/juice/core/v26.9.0/tutorials/admin/gitlab-oauth.html) and had a question on this section where after making changes it tells us to juice install –restart
Why would I not need to rebuild? I thought that the changes made in the `orchestration.toml` to the `jupyter.main_hub` would only take effect if I rebuild? I think I do understand only a restart would be needed for the changes to `secrets.env`.
Note: I have not tried this, just trying to understand rebuild vs restart better.
---
### Author:  [@Hugo](https://community.orangeqs.com/u/Hugo)
#### Post date: [February 26, 2026, 7:40am UTC](https://community.orangeqs.com/t/juice-rebuild-or-restart/26/2 "2026-02-26T07:40:21Z")
That’s a great question!
To understand why sometimes a restart is enough and sometimes a rebuild is required, it’s important to know how the contents of `orchestration.toml` are applied within Juice. The contents of `orchestration.toml` are use for two distinct things:
1. Define the configuration files for specific parts or applications within Juice. For example, specific parts of`orchestration.toml`are used to create a JupyterHub configuration file. The configuration file is not part of the image. Instead, it is created on the host system and mounted inside the image. It is read by JupyterHub when the container starts. _A restart is thus sufficient_ _in this case._
2. Define how an image should be built. For example, other parts define that package A, B and C should be installed in the image. These packages are part of the image, and are installed when the image is built. _A rebuild is thus required_ _in this case_.
It’s sometimes hard to know whether the changes you made in `orchestration.toml` will only affect situations like in 1, or that there could be a change that also affects a situation like in 2. It’s always the safest option to rebuild. On the other hand, you can always try restarting first. Then, if you notice that your change is not applied you can do a rebuild anyway. Still, specific tutorials or examples may instruct you to only restart. In those cases it’s always safe to just restart!
I hope this helps!