Skip to content

Commit 528a019

Browse files
docs: skylab is preferred
Signed-off-by: David Dal Busco <david.dalbusco@outlook.com>
1 parent 5064a0e commit 528a019

1 file changed

Lines changed: 18 additions & 14 deletions

File tree

docs/guides/local-development.mdx

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -90,17 +90,27 @@ While you could technically start the emulator using `docker run` or `podman run
9090

9191
## Available Images
9292

93-
Juno supports two main environments for running your project locally, each tailored to different use cases.
93+
Juno provides two local environments. Most developers should start with **Skylab**, but Satellite is available for advanced or specialized workflows.
9494

95-
| Image | Description | Includes Console UI | Best for |
96-
| --------------------- | -------------------------------------------- | ------------------- | --------------------------- |
97-
| `junobuild/skylab` | All-in-one local environment like production || End-to-end dev, exploration |
98-
| `junobuild/satellite` | Lightweight setup running a single Satellite || CI, focused app testing |
95+
### 🧪 Skylab: Full Local Stack (Recommended)
9996

100-
Both variants run on a local network, services and support live-reloading for serverless functions written in Rust or TypeScript.
97+
The `junobuild/skylab` image is the default and recommended environment. It mirrors the production stack and includes everything needed for end-to-end development.
10198

102-
- Use **Skylab** for the full experience, including the Console UI and supporting infrastructure.
103-
- Use **Satellite** when you want a faster, minimal setup for a specific app or automated tests.
99+
Use it for the full experience, including the Console UI and supporting infrastructure.
100+
101+
### ⚙️ Satellite: Minimal Setup
102+
103+
The `junobuild/satellite` image is a lightweight alternative that runs a single Satellite. It skips the Console UI and supporting infrastructure.
104+
105+
Use it when you need a faster, minimal setup focused on CI pipelines or automated testing.
106+
107+
:::note
108+
109+
The default (auto-deployed) Satellite is available with a predefined canister ID `jx5yt-yyaaa-aaaal-abzbq-cai`.
110+
111+
:::
112+
113+
### 📊 Feature Comparison
104114

105115
The table below shows which modules are available in each image and helps clarify what’s included when running locally with Skylab or Satellite.
106116

@@ -117,12 +127,6 @@ The table below shows which modules are available in each image and helps clarif
117127
| NNS Governance |||
118128
| Cycles Minting (CMC) |||
119129

120-
:::note
121-
122-
The default (auto-deployed) Satellite is available with a predefined canister ID `jx5yt-yyaaa-aaaal-abzbq-cai`.
123-
124-
:::
125-
126130
---
127131

128132
## Console UI

0 commit comments

Comments
 (0)