No version for distro humble showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro jazzy showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro kilted showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro lyrical showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro rolling showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro galactic showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro iron showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro melodic showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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

No version for distro noetic showing github. Known supported distros are highlighted in the buttons above.

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 (-)

README

Space Station OS

https://github.com/user-attachments/assets/5b82c516-075d-44ac-b440-fb73bedc1e91

CI Pixi CI

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