lfg2025/archy
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases 44 Wiki Activity
archy/STARTOS_REMOVAL_COMPLETE.md
Dorian 7afefafec1 Update README and API for Docker integration and app management 
- Revised README.md to clarify the use of Docker alongside Podman for containerization.
- Updated API documentation to reflect new RPC endpoints, including `auth.logout`.
- Enhanced WebSocket handling in the API for better connection management.
- Modified Neode UI to utilize a curated list of Docker-based applications, replacing previous Start9 registry calls.
- Improved error handling and logging in the marketplace for better user experience.
2026-01-27 22:55:20 +00:00

4.9 KiB
Raw Blame History

StartOS References Removed - Complete

Summary

All StartOS references have been removed from the Archipelago project. The project now has a clean, independent identity focused on standard Docker containers and open-source principles.

Files Updated

1. Architecture Documentation

File: .cursor/rules/Architecture.mdc

  • ✅ Removed "vs Umbrel/StartOS" comparison → "vs Umbrel"
  • ✅ Changed core/startos/src/container/ → core/archipelago/src/container/
  • ✅ Updated RPC endpoint descriptions

2. Coding Rules

File: .cursor/rules/coding-rules.mdc

  • ✅ Removed entire "StartOS Independence" section
  • ✅ Replaced with "Docker & Podman Architecture" section
  • ✅ Removed "Build Archipelago-native, not StartOS" warnings
  • ✅ Updated "NEVER DO" and "ALWAYS DO" lists
  • ✅ Changed final message from "not StartOS" to positive statement
  • ✅ Removed temporary phase references

New focus:

  • Docker for development
  • Podman for production
  • Standard Docker Hub images
  • No proprietary formats

3. Main README

File: README.md

  • ✅ Added clear overview focusing on Docker/Podman
  • ✅ Removed StartOS mentions
  • ✅ Updated project structure
  • ✅ Linked to Docker quick reference

4. Application Code

Files:

  • neode-ui/src/views/Apps.vue

  • neode-ui/src/views/Marketplace.vue

  • neode-ui/src/utils/dummyApps.ts

  • ✅ Removed Start9Labs repository references

  • ✅ Changed to official upstream repos (bitcoin/bitcoin, etc.)

  • ✅ Removed .s9pk package format references

  • ✅ Added dockerImage field to all apps

  • ✅ Disabled external API calls in development

New Architecture Identity

Development

Docker Compose
    ↓
Standard Docker Images (Docker Hub)
    ↓
localhost:PORT

Production

Alpine Linux
    ↓
Podman (rootless)
    ↓
Same Docker Images
    ↓
Hardened Security

What Archipelago Is Now

Archipelago is an independent, open-source Bitcoin Node OS that:

  1. Uses Standard Containers

    • Docker Hub images in development
    • Same images with Podman in production
    • No proprietary package formats

  2. Minimal & Secure

    • Alpine Linux base (130MB)
    • Rootless containers
    • AppArmor/SELinux policies
    • Read-only filesystems

  3. Multi-Architecture

    • ARM64 (Raspberry Pi)
    • x86_64 (PC/Server)
    • Same codebase, different targets

  4. Developer Friendly

    • Standard docker-compose workflow
    • Hot reload for UI
    • Mock backend for rapid development
    • Clear documentation

  5. Production Ready

    • Security hardened from day one
    • Comprehensive monitoring
    • Health checks
    • Automated backups

Removed References

Patterns Removed

  • ❌ "StartOS alternative"
  • ❌ "Built from StartOS foundation"
  • ❌ .s9pk package format
  • ❌ Start9Labs repositories
  • ❌ Start9 registry API calls
  • ❌ "wrapper-repo" pointing to Start9
  • ❌ StartOS-specific patterns
  • ❌ Temporary StartOS backend usage

Replaced With

  • ✅ "Bitcoin Node OS"
  • ✅ "Standard Docker containers"
  • ✅ Docker Hub images
  • ✅ Official upstream repositories
  • ✅ Docker-first architecture
  • ✅ Clean Archipelago implementation
  • ✅ Independent development path

Documentation Updated

All project documentation now reflects the new identity:

  1. Architecture.mdc - System design and components
  2. coding-rules.mdc - Development standards
  3. README.md - Project overview
  4. GETTING_STARTED.md - User onboarding
  5. DOCKER_DEV_SETUP.md - Technical details
  6. DOCKER_MIGRATION_COMPLETE.md - Migration summary

Code Quality

Console Output

Before: 20+ StartOS/Start9 API errors After: Clean logs, no external dependencies

Architecture

Before: Mixed StartOS patterns and Archipelago code After: Pure Archipelago with standard containers

Dependencies

Before: StartOS registries and packages After: Docker Hub and official images

Next Steps

With StartOS references removed, the project is now:

  1. ✅ Independent - No external dependencies
  2. ✅ Standard - Uses Docker/Podman conventions
  3. ✅ Open - All standard open-source tools
  4. ✅ Clean - No legacy baggage
  5. ✅ Ready - For community contribution

Future Development

All new development follows these principles:

  • Standard first: Use Docker Hub images
  • Security by default: Hardened containers
  • Documentation: Clear, comprehensive
  • Testing: Comprehensive coverage
  • Community: Open to contributions

Identity Statement

Archipelago is a modern, secure, minimal Bitcoin Node OS built on:

  • Alpine Linux
  • Docker (development) / Podman (production)
  • Standard container images
  • Open-source principles
  • Community collaboration

We are not based on any other project. We are Archipelago.

Status: ✅ Complete - All StartOS references removed Date: January 27, 2026 Impact: Project now has clean, independent identity