Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | |
| Checkout URI | https://github.com/space-station-os/space_station_os.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-09-26 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| space_station | 0.0.0 |
| space_station_communication | 0.0.0 |
| space_station_eclss | 0.8.3 |
| space_station_eps | 0.8.7 |
| space_station_gnc | 0.0.0 |
| space_station_interfaces | 0.8.7 |
| space_station_thermal_control | 0.0.0 |
| ssos_core | 0.9.0 |
| ssos_eclss | 0.9.0 |
| ssos_sim | 0.9.0 |
README
Space Station OS
https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91
Space Station OS (SSOS) is an open-source simulation of a crewed space station and its subsystems, built on ROS 2. It models the closed-loop physics of life support, power, thermal, GNC, and communications, coordinated by a shared core and a simulation controller, and visualized through a mission-control GUI.
The goal is a realistic, extensible platform for people building, researching, or learning about space stations and their subsystems.
Repository layout
| Package | What it is |
|---|---|
ssos_core |
System manager: global state model, subsystem registration, fault aggregation |
ssos_sim |
Simulation controller: world model, sim clock, scenario loading, fault injection |
ssos_eclss |
High-fidelity ECLSS physics (ARS / WRS / OGS, crew, closed loop) |
space_station |
Mission-control GUI and the top-level launch files |
Legacy Systems
| Package | What it is |
|---|---|
space_station_eclss |
Environmental Control and Life Support System |
space_station_eps |
Electrical Power System |
space_station_gnc |
Guidance, Navigation and Control |
space_station_thermal_control |
Active Thermal Control System |
space_station_communication |
Communications |
space_station_interfaces |
Shared ROS 2 messages, services, and actions |
space_station_mission_control |
OpenMCT dashboards and the OpenMCT-ROS bridge |
Choose how to use SSOS
| Goal | Recommended path |
|---|---|
| Try SSOS on Ubuntu without using the terminal after installation | Tier-1 Desktop App |
| Run SSOS from the terminal without installing system ROS 2 | Pixi |
| Develop SSOS in a reproducible environment | Pixi |
| Develop and integrate against a native ROS 2 installation | Ubuntu 24.04 + ROS 2 Jazzy |
| Work with the containerized environment | Docker (advanced) |
Pixi is the recommended reproducible environment for most SSOS development. Native ROS 2 Jazzy is supported for system integration and development against a system ROS installation.
Try SSOS as a Desktop App
The Tier-1 Desktop App is supported on Ubuntu 24.04 Desktop. It creates a Space Station OS shortcut that launches the full mission-control stack through the repository’s Pixi environment.
Starting from a clean Ubuntu 24.04 Desktop installation:
sudo apt update
sudo apt install -y curl git zenity
curl -fsSL https://pixi.sh/install.sh | sh
export PATH="$HOME/.pixi/bin:$PATH"
git clone https://github.com/space-station-os/space_station_os.git
cd space_station_os
bash desktop/install.sh
The installer uses the committed pixi.lock, builds SSOS, and places a
Space Station OS icon on your Desktop.
Double-click the icon to launch SSOS. On first launch, if GNOME displays an untrusted-launcher warning, right-click the icon and choose Allow Launching.
To uninstall the shortcut:
bash desktop/uninstall.sh
The repository and Pixi environment are not removed.
See docs/DESKTOP_APP.md for details and troubleshooting.
Run SSOS from the Terminal with Pixi
Pixi provides ROS 2 Jazzy through RoboStack and does not require a system ROS 2
installation, rosdep, or a ROS-specific apt setup.
File truncated at 100 lines see the full file