backend/app/services/referral/referral_v2.py. The ambassador and community-channel programs described below are launch-aligned and partly in development at the time of writing.
Referrals at scale: ambassador and community
Stage 3 chapter 6 covers the basics: find your code, share the link, earn 5% of referee earnings for 180 days, climb tiers as your active referral count grows.
This chapter is for the hero-user who has saturated the "share with friends" channel and wants to operate referrals as a deliberate side income — multiple channels, content production, community-building, and the legal disclosures that come with all of it.
When you've outgrown Stage 3
Stage 3 mechanics scale to roughly 10-30 referred users — a typical personal network. Past that point, you need multi-channel distribution, original content, a community presence, and disclosure discipline.
Tiered referrals (verified in referral_v2.py::get_user_tier) increase your reward_percentage as your active referral count rises. At sufficient scale the referral stream becomes meaningful next to your own device earnings.
The power-referrer playbook
What top affiliate operators in adjacent spaces (Tailscale, Storj, Helium) actually do:
Channel 1: YouTube device reviews
Long-tail evergreen content. "I let Zyra run on my 5-year-old gaming PC for 30 days — here's what it earned" is a thumbnail that ages well.
- Show real dashboard numbers. Blur PII; show earnings honestly.
- Pin the referral link with an FTC disclosure (see below).
- Update annually. Year 2 and 3 videos compound.
[VERIFY: brand asset kit for YouTubers — landing/press.html exists; a creator-specific kit is post-launch work.]
Channel 2: Subreddit and forum discussions
The honest-review post in r/homelab, r/sideproject, r/passive_income outperforms a thousand cold DMs.
- Disclose the referral relationship in the post body, not just the link.
- Lead with what doesn't work. Communities smell a sales pitch.
- Answer follow-up questions for weeks. Month-old replies build the funnel.
Channel 3: Local maker meetups and homelab groups
Underrated. Hardware communities (Meetup, hackerspaces, university CS clubs, regional Discord servers) contain a high concentration of people with idle hardware. A 20-minute talk reaches 30 people who own 60 devices.
Channel 4: Newsletter and blog
A modest tech newsletter (500-2000 subscribers) can drive steady referrals. One annual post on "what's earning right now" with a CTA at the bottom is enough.
Channel 5: Comparison posts
Honest comparison content (Storj vs Helium vs Zyra) has high SEO value and pre-qualifies the reader. If you write it fairly, it tends to rank.
The ambassador program
[VERIFY: ambassador program — at the time of writing (Q2 2026) the structure is being designed; the referral-tier ladder in referral_v2.py is the technical foundation, but ambassador-specific benefits are not yet public. Treat this as forward-looking until we publish the program terms.]
The intended shape:
- Top-tier referrers get invited to an ambassador track.
- Benefits: elevated
reward_percentage, custom landing page, monthly founder call, early access to new device features. - Obligations: quarterly content output, one community-facing post per month, basic professionalism in public.
If you are in the top 5% of referrers at launch, you'll get an invite email.
The beta-tester role
New device-agent features (GPU partitioning, ARM Linux support, advanced scheduling) need testing on real hardware before going to the full fleet. Beta testers run a pre-release agent on a subset of their devices, file structured bug reports (template in Stage 4 chapter 5), and get acknowledged in the changelog when a feature ships.
[VERIFY: beta-channel registration UI — the auto-updater in desktop/src/main/autoUpdater.ts supports staged rollouts; user-facing opt-in toggle at Settings → Beta features, surface pending at GA.]
Building a small operation around referrals
The honest math: even at hero-tier rates, referrals are a side income, not a primary. Pattern that works:
- Primary: your own device fleet (Stage 4 chapter 6).
- Secondary: referrals from content you produce anyway.
- Tertiary: ambassador-program perks (co-marketing, early access, founder access).
Where it goes wrong: trying to make referrals the primary income. You then have an incentive to oversell, content becomes spammy, communities ban you, and the referrals dry up. Community trust is the constraint.
FTC disclosure rules (US)
The US FTC requires affiliate / referral relationships be disclosed clearly and conspicuously.
- YouTube: description plus voiceover in the first 30 seconds — "I have a referral relationship with Zyra; if you sign up using my link, I earn a small percentage of your earnings."
- Blog posts: disclosure at the top, not buried at the bottom.
- Social media:
#ador#sponsoredtags on every post with a referral link. - Email newsletters: disclosure in the same email where the link appears.
[VERIFY: legal review by a US-licensed attorney is recommended before publishing at scale; Zyra cannot give legal advice.]
EU and UK rules
EU member states implement the Unfair Commercial Practices Directive; the UK has the CMA's hidden-marketing guidance. Effectively similar to FTC in practice: disclose clearly, use platform-native labels (Instagram "Paid partnership", etc.), keep disclosure in the same medium as the promotion.
[VERIFY: country-specific advice — particularly Germany's strict influencer rules — should come from local counsel.]
What gets you banned
- Sock-puppet signups — creating accounts for friends. Detected by IP/device fingerprinting; results in referral clawback and account suspension.
- "Guaranteed earnings" claims — earnings depend on marketplace demand. False advertising and a ToS violation.
- Comment spam — embedding referral links in unrelated comments triggers community bans and ToS violations.
- Paid-traffic schemes — most paid-traffic referrals are fraud-flagged; the bonus is clawed back.
Cross-links
- Stage 3 chapter 6: Earn from referrals — base mechanics
- Stage 4 chapter 5: Community, forum, and support — community channels and bug reporting
- Stage 4 chapter 6: Running a Zyra business — tax and entity treatment of referral income
What's next
3. Reading the marketplace: when demand is high →
Last reviewed: 2026-05-21