selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

iCloud Prime logo

Self-host iCloud Prime

v0.1.10

Local web console for iCloud Hide My Email alias management

BetaOpen SourceMIT
Updatedlast week
LanguageGo
Setup difficultyModerate
Stars
150
Port
8081 (HTTP web console and API)
Install with Docker
Account overview screen showing managed iCloud accountsAlias creation screen for generating new Hide My Email aliasesAlias list screen showing all aliases for an accountInbox screen showing emails received at aliasesVerification codes screen showing extracted codes from emailsSettings screen for configuring API token and other options

What is iCloud Prime?

This application provides a local web dashboard and HTTP API to manage Apple's Hide My Email aliases. It supports multiple iCloud accounts, lets you create and list aliases, schedule automatic generation by duration or daily windows, and batch create up to five aliases per account per hour. Messages sent to aliases are fetched via IMAP using an app-specific password, with a web API cookie fallback. You can run it via a Windows 10 portable package, a Docker image, or by building from source with Go 1.26+ and Node.js 20+. Account data and scheduled jobs persist locally in JSON files. Both global and China-region iCloud endpoints are supported, along with optional HTTP/SOCKS5 proxy settings. Remote access requires an API token. Licensed under MIT.

Should you self-host iCloud Prime?

iCloud Prime scores 43/100 on selfhost.directory (how scoring works) and ranks #82 of 106 in Email. It has 150 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.1.10, came out on 16 September 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Listmonk (80/100, 24 018 stars). It scores higher overall, so compare the two before you pick. See iCloud Prime vs Listmonk side by side.

Features

  • Batch alias creation
  • Create Hide My Email aliases
  • Dual region support
  • Hourly quota management
  • List and manage aliases
  • Local data persistence
  • Multi-account Management
  • Proxy Support
  • Read mail via IMAP and web fallback
  • REST API
  • Scheduled automatic alias creation
  • Windows 10 portable release

iCloud Prime README

How to install iCloud Prime

Install iCloud Prime with Docker

Docker Engine
Environment variables
ICLOUD_PRIME_API_TOKEN

docker run --rm -p 127.0.0.1:8081:8081
-e ICLOUD_PRIME_API_TOKEN=REPLACE_WITH_A_LONG_RANDOM_TOKEN
-v icloud-prime-data:/app/data icloud-prime

Requires ICLOUD_PRIME_API_TOKEN; mount persistent volume at /app/data

How to configure iCloud Prime

  • -addr127.0.0.1:8081Listen address and port for the web console and API

    Listen address and port for the web console and API

    values: Any valid address:port (e.g., 127.0.0.1:9000, :8081)

  • -data.\dataData directory for accounts.json, create_jobs.json, and logs

    Data directory for accounts.json, create_jobs.json, and logs

    values: Any valid filesystem path

  • -debugfalseEnable debug logging

    Enable debug logging

    values: true/false (flag)

  • ICLOUD_PRIME_API_TOKENAPI access token required for remote access (binding to non-loopback address) and for Docker deployments

    API access token required for remote access (binding to non-loopback address) and for Docker deployments

    values: Any long random string

iCloud Prime releases & version history

More in Self-hosting

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…