FamilyCloudSetup guide

Technical overview and setup guide.

The decision’s been made. Here’s everything you need to evaluate the setup and get FamilyCloud running.

This page covers what FamilyCloud actually requires to run, how to set it up from scratch, and how to migrate an existing photo/media library. If you’re here because someone in your family shared this link, you’re in the right place.

System requirements

What FamilyCloud needs to run

Mac

Any Apple Silicon Mac (M1 or later). macOS Sequoia 15.3 or later.

Recommended: Mac mini M4 for always-on server use. 6W idle, fanless under normal media workloads.

RAM

8 GB minimum. 16 GB recommended for libraries over 500 GB or simultaneous streams above 3.

Storage

External USB-C or Thunderbolt drives. FamilyCloud spans multiple volumes automatically. Internal SSD is used for the app and index only — not media storage.

Network

Ethernet recommended, not required. Minimum 10 Mbps upload for remote streaming. 25 Mbps recommended for 4K.

Internet

Standard residential ISP. No static IP required. No port forwarding required. FamilyCloud uses CGNAT hole-punching for remote access. Works on Starlink, CGNAT cable, and standard fiber.

Hardware

Recommended hardware configurations

Starter

Solo or small family, up to 4 TB

~$800

total

Mac mini M4 base$599
Samsung T7 Shield 4 TB USB-C~$200
Standard

Family of 5–10, up to 24 TB usable

~$1,618

total

Mac mini M4 base$599
OWC ThunderBay 4 mini Thunderbolt enclosure$299
4× Seagate IronWolf 8 TB NAS drives$180 ea. / $720

Configure as RAID 5 (24 TB usable, 1 drive fault-tolerant) or JBOD with FamilyCloud software RAID.

Multi-site secondary node

Offsite backup + remote access

~$610–$710

per node

Used Mac mini M1 or M2$400–$500 used
Seagate IronWolf 8 TB in USB-C enclosure~$210

Installation

Installing FamilyCloud

1

Download

Download FamilyCloud from skyfiresystems.com/familycloud.

2

Install

Move FamilyCloud.app to /Applications. Launch it.

3

First-run wizard

a.Create an admin account with a passphrase. This passphrase derives your encryption keys — store it somewhere safe.
b.Select storage volumes.
c.Configure remote access. Automatic — no router configuration needed.
4

Add family members

Go to Settings → Members. Each member gets an invite link. They install the FamilyCloud app on their device and enter the invite code.

5

Configure phone backup

On each member's device, enable auto-backup in the FamilyCloud mobile app. Backup runs on Wi-Fi only by default.

Migration

Importing existing libraries

From Google Photos

1.Go to takeout.google.com. Request a Google Photos export. Select all albums. Export as ZIP.
2.Download arrives in 1–24 hours depending on library size.
3.In FamilyCloud → Settings → Import → Google Photos Takeout. Point to the downloaded ZIP or extracted folder.
4.FamilyCloud preserves original dates, locations, and album structure from the Google metadata JSON files.
5.Import runs in background. Google Photos continues working normally throughout.

From iCloud Photo Library

1.On a Mac with iCloud Photo Library enabled: open Photos.app. File → Export → Export Unmodified Originals.
2.Export to an external drive. This preserves EXIF metadata.
3.FamilyCloud → Import → Photos Library. Point to the export folder.
4.iCloud continues syncing normally. FamilyCloud runs independently.

From Plex

FamilyCloud will discover media in any folder you point it to. Add your existing Plex media folder as a watched library in FamilyCloud → Settings → Media Sources. Plex can continue running in parallel — both will index the same files.

Multi-site

Multi-site replication setup

1

Set up the primary node first (complete steps above).

2

On the secondary machine, download and install FamilyCloud.

3

In primary FamilyCloud → Settings → Multi-site → Add Node. Generate a pairing code.

4

On the secondary machine, enter the pairing code. The two nodes establish an encrypted peer-to-peer sync connection.

5

Initial sync: FamilyCloud copies the full library to the secondary node. Depending on library size and connection speed, this may take several hours to days on first run. Subsequent syncs are incremental.

6

Failover is automatic: if the primary goes offline, remote clients switch to the secondary node within 60 seconds.

Access control

Role management

Owner

Full system access. Can manage all settings, members, and storage. First account created during setup.

Admin

Can manage members and view system settings. Cannot change encryption or storage configuration.

Member

Full library access. Can upload, share, and manage their own content. Cannot manage other members.

View-only

Can see the shared library and auto-backup their own device. Cannot upload or manage content. Ideal for grandparents, distant relatives, or children's accounts.

Roles are assigned per invite. An admin can change a member’s role at any time.

Networking

Network and firewall notes

No inbound rules required

FamilyCloud does not require any inbound firewall rules or port forwarding. Outbound HTTPS (port 443) only.

CGNAT hole-punching relay

The CGNAT hole-punching relay is operated by Skyfire — it establishes the connection path but never sees the content. All media is end-to-end encrypted.

Air-gapped / LAN-only mode

For air-gapped or strictly firewalled environments, FamilyCloud can be configured for LAN-only mode (no remote access), which requires no outbound connection whatsoever.

Recovery

Backup and recovery

Point-in-time history

FamilyCloud maintains a 30-day point-in-time history for all files by default (configurable). Accidental deletions, overwrites, and ransomware events can be rolled back from Settings → Recovery.

SkyFire Recovery is included — no separate license required.

Drive failure recovery

Replace the failed drive, add it to the enclosure, and FamilyCloud rebuilds the data from the remaining drives (RAID 5) or from the secondary node. No manual intervention beyond the physical swap.

Questions?

Reach out at familycloud@skyfireworks.io