Skip to content

cosmospkg/example-galaxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌌 Cosmos Example Galaxy

A minimal Galaxy for Cosmos used to demonstrate local and offline installation flows.

This repository contains a basic working Galaxy with a small, statically linked hello binary and a sample Nebula (core-stack) to show how a Cosmos install flow works.


📦 Included Stars

  • hello – statically linked binary, installs to /usr/bin/hello
  • core-stack – a Nebula that depends on hello, simulates a base install stack

📂 Layout

example-galaxy/
├── meta.toml
├── stars/
│   ├── hello.toml
│   └── core-stack.toml
├── packages/
│   └── hello-0.1.0.tar.gz

🚀 Quick Usage

  1. Add this Galaxy to your config.toml:
[galaxies]
example = "file:///path/to/example-galaxy"
  1. Run a test install:
cosmos install core-stack --root ./test-root
  1. Inspect:
ls ./test-root/usr/bin
./test-root/usr/bin/hello

Run it if you’re brave:

chroot ./test-root /usr/bin/hello

🤖 What This Galaxy Is

  • A working example of a local/offline Cosmos Galaxy
  • A reference for Galaxy structure and metadata layout
  • A testable install target for Stellar-built packages

🧠 What This Galaxy Is Not

  • Secure
  • Signed
  • Maintained for long-term use
  • A full Linux base system (see LFS Galaxy)

🧰 Dev Notes

To build a new package:

stellar new-star mypkg
# edit star.toml and files/
stellar build-star ./mypkg
# move the .tar.gz to packages/ and star.toml to stars/

Then update meta.toml to include the new Star and version.


🔗 Links


If you can install this, you can install the world.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published