Upstream repo: https://github.com/Start9Labs/hello-world
A minimal reference service for StartOS. It displays a simple web page — nothing more. Use this repository as a template when packaging a new service for StartOS.
To learn how to use this template to create your own StartOS service package, see the Packaging Guide.
- Image and Container Runtime
- Volume and Data Layout
- Installation and First-Run Flow
- Configuration Management
- Network Access and Interfaces
- Actions (StartOS UI)
- Backups and Restore
- Health Checks
- Dependencies
- Limitations and Differences
- What Is Unchanged from Upstream
- Contributing
- Quick Reference for AI Consumers
| Property | Value |
|---|---|
| Image | ghcr.io/start9labs/hello-world |
| Architectures | x86_64, aarch64, riscv64 |
| Command | hello-world |
| Volume | Mount Point | Purpose |
|---|---|---|
main |
/data |
Persistent data |
No special setup. Install and start — the web page is immediately available.
No configurable settings. The service runs with no user-facing configuration.
| Interface | Port | Protocol | Purpose |
|---|---|---|---|
| Web UI | 80 | HTTP | Hello World web page |
Access methods:
- LAN IP with unique port
<hostname>.localwith unique port- Tor
.onionaddress - Custom domains (if configured)
None.
Included in backup:
mainvolume
Restore behavior: Volume is fully restored before the service starts.
| Check | Method | Messages |
|---|---|---|
| Web Interface | Port listening (80) | Success: "The web interface is ready" / Error: "The web interface is not ready" |
None.
- No meaningful functionality — this is a reference/template package only
The service is identical to upstream. There are no modifications.
See CONTRIBUTING.md for build instructions and development workflow.
package_id: hello-world
image: ghcr.io/start9labs/hello-world
architectures: [x86_64, aarch64, riscv64]
volumes:
main: /data
ports:
ui: 80
dependencies: none
startos_managed_env_vars: none
actions: none