TopGit
GitHub Repo Review

AssppWeb iOS IPA installer: self-hosted review

Lakr233/AssppWeb
ATopGit review image for Lakr233/AssppWeb
Review by Topgit.dev for Lakr233/AssppWeb, with GitHub repository stats and README context.
Quick verdict

AssppWeb is a practical self-hosted iOS IPA installer for users willing to operate the security boundary themselves. Its browser-side credential handling is thoughtful, but a public host can still serve altered code; self-hosting and HTTPS make it worth using.

Stars
โ˜… 4.1k
Forks
โ‘‚ 667
Contributors
๐Ÿ‘ฅ 13
Language
TypeScript
License
MIT
Topic
โ€”
Updated
Oct 2026
Homepage
โ€”

A self-hosted iOS app installer

AssppWeb is a self-hosted iOS sideloading web app that signs into Apple services, searches for apps, obtains licenses, and builds installable IPAs. Apple API traffic stays in the browser through WebAssembly, while the server relays TCP and compiles files from public CDN downloads.

Installing IPAs without the App Store

AssppWeb provides a browser-based workflow for obtaining iOS apps from outside the App Store, and server operators need not provide Apple ID credentials. It combines Apple ID authentication, license acquisition, downloading and compiling an IPA, and device installation all within one deployable service.

Browser-side authentication and blind relay

  • โœ“Apple ID authentication runs inside the browser, keeping credentials away from the AssppWeb server under its intended operating conditions.
  • โœ“Apple API requests use WebAssembly with libcurl.js and Mbed TLS 1.3, avoiding an Apple executable or private framework.
  • โœ“The backend operates as a blind TCP relay through the Wisp protocol rather than interpreting the encrypted application traffic.
  • โœ“A fresh browser-side SAP exchange signs the exact request body with X-Apple-ActionSignature, while verification-code submissions continue in the same in-memory session.
  • โœ“Compiled IPAs are downloaded from public CDN sources and exposed through install manifests for itms-services installation on a device.
  • โœ“Deployments can use a local Docker Compose setup, Cloudflare Workers with Containers, Railway, or a manually managed Docker Compose server.
How this repository's GitHub stars have grown over time. Source: star-history.com.View the star history โ†—

Deployment options and requirements

For a local source build with OrbStack or Docker, run `docker compose -f compose.yml -f compose.local.yml up --build -d`, then open `http://localhost:8080`. For Docker Compose, download `compose.yml` with `curl -O https://raw.githubusercontent.com/Lakr233/AssppWeb/main/compose.yml` and run `docker compose up -d`. Cloudflare deployment uses Workers with Containers and the `ghcr.io/lakr233/assppweb:latest` image, but requires a paid plan and the specified Workers, Containers, and Cloudchamber permissions. Railway can deploy the same image; configure `/api/settings` as the healthcheck path, mount `/data`, and set `DATA_DIR=/data`. iOS installation requires a reverse proxy with a valid TLS certificate and working WebSocket support.

Strengths

  • โœ“Credentials remain in the browser during the normal AssppWeb flow instead of being submitted to the backend.
  • โœ“The Wisp relay and WebAssembly request stack make the intended security boundary unusually explicit.
  • โœ“Deployment choices cover local development, Railway, Cloudflare, and conventional Docker Compose hosting.
  • โœ“IPA compilation, install manifests, storage controls, and access-password settings are handled by the same application.
  • โœ“The MIT license makes the AssppWeb source available for inspection, modification, and commercial use.

Security and infrastructure limitations

  • โ–ณA public AssppWeb host can serve a modified frontend that captures Apple credentials before encryption. There are no official public instances, so self-hosting or a trusted partner is the sensible choice.
  • โ–ณInstalling apps through itms-services requires HTTPS with a valid certificate. Misconfigured forwarded-protocol headers can also cause redirect loops.
  • โ–ณThe reverse proxy or CDN must support WebSocket connections at `/wisp/`; otherwise AssppWeb cannot communicate with Apple servers.
  • โ–ณCloudflare deployment requires a paid plan because Workers Containers are unavailable on the free plan.
  • โ–ณPublic instances need rate limiting, access controls, and CDN protection because IPA downloads can consume substantial bandwidth.

Related iOS acquisition projects

ipatool โ€” an acquisition-focused project acknowledged by AssppWeb, useful when direct Apple ID acquisition matters more than a browser-based installer.Asspp โ€” the closely related project acknowledged by AssppWeb, providing another reference point for iOS app acquisition workflows.ApplePackage โ€” the implementation reference behind AssppWeb's ported direct algorithm, rather than a drop-in web deployment equivalent.

Frequently asked questions

Does the AssppWeb server receive my Apple ID credentials?

The AssppWeb server is designed not to receive Apple ID credentials because Apple API communication runs in your browser through WebAssembly. However, an untrusted host could modify the frontend and capture credentials before encryption, which is why self-hosting is recommended.

Why should I self-host AssppWeb instead of using a public instance?

Self-hosting AssppWeb lets you control which frontend code is served and where the service runs. A public instance could serve altered JavaScript that captures Apple credentials before encryption, and the AssppWeb README states there are no official public instances.

What does AssppWeb require to install apps on iOS?

AssppWeb needs a reverse proxy with a valid TLS certificate because iOS requires HTTPS for itms-services installation links. The proxy must also allow WebSocket connections at `/wisp/` so the browser-side Apple communication can reach the relay.

Can I deploy AssppWeb to Cloudflare Workers for free?

The AssppWeb Cloudflare deployment cannot use Workers Containers on the free plan. A paid Cloudflare plan is required, along with a deployment token that grants Workers Scripts Edit, Containers Edit, and Cloudchamber Edit permissions.

How is the Wisp protocol used by AssppWeb?

AssppWeb uses the Wisp protocol over WebSocket to provide a blind TCP relay for browser-side Apple API traffic. The server transports the connection without receiving the Apple ID credentials or encrypted application payload handled by the browser.

Can I use AssppWeb commercially under the MIT license?

Yes. AssppWeb is distributed under the MIT License, which permits commercial use, modification, distribution, and sublicensing. The license terms still apply, including preservation of the license and copyright notice.

Best use cases

  • โ€ขFor a home-lab operator who wants to run the complete iOS acquisition and installation flow on hardware they control.
  • โ€ขWhen an organization needs a private AssppWeb instance rather than trusting an unknown public frontend with Apple authentication.
  • โ€ขFor testing an iOS sideloading web app against local source changes before making the service available to other users.
  • โ€ขWhen Railway or Cloudflare deployment fits an existing cloud operations setup and the paid-container requirements are acceptable.

Who should try it โ€” and who should skip

AssppWeb suits self-hosters and technically experienced iOS users who want an iOS IPA installer under their own control. It is a poor casual choice for anyone unwilling to secure a server, validate TLS, support WebSockets, and trust the frontend code served to the browser. Users who only need occasional App Store distribution should use Apple's normal installation path instead.

Source & attribution

Source: [Lakr233/AssppWeb on GitHub](https://github.com/Lakr233/AssppWeb), including the repository README and MIT License metadata.

GitHub data ยท last synced Nov 7, 2026Reviewed by Henry
โ† Back to TopGit

Still deciding about AssppWeb?

One click hands the question to an AI along with this page โ€” see what it says about AssppWeb.

GitHub