IKHSAN
ENID Baca dalam Bahasa Indonesia

homeio

Public

Forked from doctor-io/homeio

Branch
main
Latest commit
958d74616 October 2026

marketing-promotion-plan.md

Open raw
Homeio Promotion Plan

Updated: 2026-04-18

1. Product Analysis

What Homeio already ships

Based on the current repository, README, routes, and modules, Homeio is not just a dashboard. It is a self-hosted home server control surface with:

  • Desktop-style shell UI: dock, windows, widgets, lock screen, command palette
  • Docker app management: install, update, uninstall, redeploy, logs, compose editing, custom app install
  • App Store compatibility with CasaOS-style store archives and custom sources
  • Real-time monitoring through SSE for system metrics, network events, Docker stats, and store operations
  • File management: browse, upload, download, copy/move, trash, starred files, previews, ZIP, search
  • Network storage: local folder sharing plus SMB share discovery, mount, and unmount
  • Built-in terminal with an explicit command allowlist instead of a full shell
  • System controls: updates, rollback, backups, shutdown, reboot, scheduled power actions
  • Network management via NetworkManager / D-Bus
  • Single-user authentication with registration bootstrap flow
  • Docker image publishing and GitHub release automation in CI

Core value proposition

Homeio’s value is not "yet another Docker UI".

It combines three things that are usually fragmented:

  1. App deployment and lifecycle management
  2. System visibility and server operations
  3. A much more approachable desktop-like user experience for homelab users

Strongest differentiators

  • Better first impression than utilitarian dashboards
  • Strong "no-SSH for daily tasks" story
  • Real-time visibility built into the product, not bolted on
  • Useful for Raspberry Pi / mini-PC / Debian home server setups
  • Practical overlap between app management, files, terminal, backups, and networking

Best-fit audience

  • Self-hosters who find Portainer too infrastructure-heavy
  • CasaOS or Umbrel users who want more control without dropping to raw Docker full-time
  • Raspberry Pi and mini-PC homelab users
  • Users setting up a family/home server and wanting a friendly UI
  • Open-source contributors interested in self-hosted UX, not only backend infra

2. Message Positioning

Recommended short positioning

Homeio is a self-hosted server manager with a desktop-style UI for running Docker apps, files, terminal, and system operations from one place.

Recommended comparison framing

Use this framing consistently:

  • Alternative to CasaOS, Umbrel, and Portainer
  • More approachable than Portainer
  • More operational than a homepage/dashboard
  • More cohesive for daily homelab use than stitching multiple tools together

Messaging pillars

  • Control your homelab without living in SSH
  • Manage apps, files, terminal, network, and system state from one interface
  • Desktop-like UX for self-hosting, not another admin panel

3. Friction To Fix Before Promotion

These are worth tightening before broad outreach because self-hosted communities inspect repos closely.

  • Keep CONTRIBUTING.md current
    • The file now exists; keep setup, branch, test, and PR expectations aligned with the codebase.
  • Keep versioning consistent
    • package.json is in the 1.6.x release line.
    • ROADMAP.md now documents v1.6.x as the current line.
    • Tags and GitHub releases should be checked before any broad launch push.
  • Make contribution entry points obvious
    • add good first issue, help wanted, and module-scoped labels
  • Publish one clear installation matrix
    • Docker
    • bare metal / Debian / Ubuntu / Raspberry Pi OS
    • what works only with NetworkManager / D-Bus
  • Add a 60-90 second demo GIF/video
    • desktop shell
    • app install
    • file preview
    • terminal
    • metrics
  • Prepare a "Why Homeio exists" launch post
    • communities respond better to narrative + tradeoffs than raw feature lists

4. Best Sites And Communities To Target

Priority order is based on relevance to self-hosted / homelab software and likelihood of reaching both users and contributors.

Tier 1: Must target

1. selfh.st/apps

Why it matters:

  • Highly relevant self-hosted discovery surface
  • Official directory for self-hosted software
  • Maintainer explicitly invites developers to reach out to add projects
  • The platform reported 900+ projects and nearly half a million monthly directory views in January 2025

How to use it:

  • Submit Homeio for listing
  • Pitch it for Self-Host Weekly coverage
  • After listing, optionally evaluate paid partnership only if organic response is promising

Best angle:

  • "Desktop-style self-hosted server manager for Docker apps, files, terminal, and system operations"

Links:

2. Awesome-Selfhosted

Why it matters:

  • Massive discovery surface inside the self-hosted ecosystem
  • Strong contributor visibility because developers browse it directly
  • The GitHub repo currently shows 287k stars and 1,200+ contributors

How to use it:

  • Submit Homeio to the most appropriate category
  • Treat this as a credibility move more than a traffic spike

Best angle:

  • "Self-hosting solution" or adjacent category depending on maintainers' criteria

Links:

3. r/selfhosted

Why it matters:

  • One of the main discussion hubs for this exact audience
  • Strong feedback loop for bugs, missing docs, installation pain, and feature demand

How to use it:

  • Post only when the launch post meets the subreddit self-promo requirements
  • Lead with what problem Homeio solves and why it exists
  • Include install docs, screenshots, a concise feature list, and explicit value to self-hosters

Important moderation constraints:

  • The app must be self-hostable
  • It must be released and available to try
  • It must have documentation
  • The post must explain what it does, key features, and why it helps users

Link:

Tier 2: High-value supporting channels

4. Noted.lol

Why it matters:

  • Self-hosted publication with a directory and contributor model
  • Explicitly invites developers to introduce their self-hosted projects

How to use it:

  • Submit Homeio to the directory
  • Pitch a guest article such as:
    • "Why I built a desktop-style UI for self-hosting"
    • "Managing a Raspberry Pi home server without SSH"
    • "What CasaOS and Portainer still leave open for homelab UX"

Links:

5. Mastodon hashtags: #selfhosted and #homelab

Why it matters:

  • Relevant open-source audience
  • Good channel for launches, release notes, and demo clips
  • selfh.st explicitly cites those communities as part of the ecosystem it draws from

How to use it:

  • Post short demo videos
  • Post release threads with one concrete improvement per post
  • Reply to related discussions instead of only broadcasting

Reference:

Tier 3: Use carefully

6. r/homelab

Why it matters:

  • Big overlap with Homeio’s target user
  • Good for tutorial or build-log style content

Why not primary:

  • Direct product promotion is moderated aggressively
  • Safer approach is educational content first, product second

Best use:

  • "How I built a desktop-like control surface for my home server"
  • "Managing Docker apps, files, and backups from one Raspberry Pi UI"

Reference:

5. Recommended Launch Sequence

Phase 0: Pre-launch cleanup

Do this first:

  1. Add CONTRIBUTING.md
  2. Fix versioning inconsistencies across package.json, tags, releases, and roadmap
  3. Produce a short demo video/GIF
  4. Prepare three screenshots:
    • desktop shell
    • app store / compose management
    • file manager + terminal + metrics
  5. Create 5-10 labeled starter issues
  6. Add "Good first issue" and "Help wanted" labels

Phase 1: Discovery surfaces

Do within the same week:

  1. Submit to selfh.st/apps
  2. Reach out to selfh.st for newsletter consideration
  3. Submit to Awesome-Selfhosted
  4. Submit or pitch to Noted.lol directory/editorial

Goal:

  • make Homeio discoverable where self-hosters already search for new projects

Phase 2: Community launch

Do after discovery listings are ready:

  1. Publish a launch post on r/selfhosted
  2. Publish a Mastodon launch thread with screenshots/video
  3. Publish a GitHub release post with clear highlights

Goal:

  • convert curiosity into GitHub stars, installs, and issue traffic

Phase 3: Content-driven growth

Over the next 4-6 weeks:

  1. Publish one technical article
  2. Publish one comparison article
  3. Publish one setup tutorial

Recommended topics:

  • Homeio vs CasaOS vs Portainer for home servers
  • Building a no-SSH homelab workflow
  • Running Homeio on Raspberry Pi / Debian

Goal:

  • bring in search traffic and higher-intent users

Phase 4: Contributor acquisition

Once traffic starts:

  1. Post "good first issues" visibly
  2. Add architecture docs for modules
  3. Publish a "where contributors can help" page
  4. Thank external contributors publicly in releases

Goal:

  • convert interest into sustained open-source participation

6. Suggested Content Assets

Directory pitch

Homeio is a self-hosted server manager with a desktop-style UI for managing Docker apps, files, terminal access, backups, updates, and live system metrics from one place. It is aimed at homelab and home server users who want something more approachable than infrastructure-heavy admin panels without giving up operational control.

r/selfhosted post skeleton

Title:

Homeio: desktop-style self-hosted server manager for Docker apps, files, terminal, and live system metrics

Body structure:

  1. Problem:
    • most home server workflows still bounce between SSH, Docker tools, file browser, and system utilities
  2. What Homeio is:
    • a self-hosted control surface for common homelab tasks
  3. Key features:
    • desktop shell
    • Docker app store / compose management
    • file manager
    • terminal with allowlist
    • backups / updates / monitoring / networking
  4. Who it is for:
    • Raspberry Pi, mini-PC, Debian/Ubuntu home servers
  5. Links:
    • GitHub
    • install docs
    • screenshots / demo
  6. Ask:
    • feedback on install flow, UX rough edges, and missing workflows

Contributor CTA

If you want contributors, ask for narrow help:

  • polish UX consistency
  • improve install coverage
  • add storage and backup workflows
  • improve docs for networking and hardware-specific cases

Avoid generic asks like:

  • "contributors welcome"

Use specific asks like:

  • "Looking for help on Raspberry Pi testing, onboarding docs, and file-manager UX polish"

7. Success Metrics

Track weekly:

  • GitHub stars
  • GitHub issues opened by new users
  • PRs from first-time contributors
  • installs from release announcements
  • referral traffic from selfh.st, Reddit, Noted, Mastodon
  • docs visits for install pages

Best early signals:

  • people successfully install it without hand-holding
  • people compare it to CasaOS / Portainer unprompted
  • contributors start picking up scoped issues

8. Practical Recommendation

If you only do three things in the next two weeks, do these:

  1. Fix repo credibility gaps: CONTRIBUTING.md, version consistency, starter issues
  2. Get listed on selfh.st/apps and submit to Awesome-Selfhosted
  3. Launch on r/selfhosted with a strong demo and a narrative post, not just a link drop

9. Sources

bytes
12,053
lines
399
Type
md
Latest commit
16 October 2026