hautvfami/ipa-server

By hautvfami

Updated 9 months ago

Supported platforms: amd64, arm64(Apple Silicon)

Image
Languages & frameworks
Integration & delivery
Developer tools
0

531

hautvfami/ipa-server repository overview

📱 Free IPA & APK Server – Self-Hosted Mobile App Installer

Easily host and distribute your iOS .ipa and Android .apk files with this lightweight self-hosted mobile app distribution server. Perfect for internal testing, team sharing, or enterprise app distribution — without relying on third-party services.


🚀 Features

  • 🧬 Upload & Host IPA/APK – Share your iOS & Android apps securely.
  • 🌐 Install Directly on Devices – Supports iOS OTA install and Android direct download.
  • ☁️ Optional Remote Storage – Integrate with S3, AliOSS, or Qiniu Cloud.
  • 🧠 Metadata Storage – Keep your app metadata in a secure local file.
  • 🗑️ Delete Enabled – Allow or restrict app deletion easily.
  • ⚙️ Simple Deployment – One command to start everything via Docker Compose.

🧮 Requirements

  • Docker & Docker Compose installed
  • A domain or subdomain pointing to your server’s IP
  • Optional: SSL certificate (recommended for iOS OTA install)

🧩 Deployment Guide

1️⃣ Clone or create a new folder
mkdir ipa-server && cd ipa-server
2️⃣ Create a docker-compose.yml file

Copy the following content:

version: "2"

services:
  web:
    build: .
    image: hautvfami/ipa-server:latest
    container_name: ipa-server
    restart: unless-stopped
    environment:
      # server public url
      - PUBLIC_URL=https://your-domain.com
      # optional: remote storage (S3, AliOSS, Qiniu)
      - REMOTE=
      # optional: remote public URL (e.g. CDN)
      - REMOTE_URL=
      # optional: metadata storage path
      - META_PATH=storage.json
      # enable delete feature
      - DELETE_ENABLED=true
    ports:
      - "80:8080"
    volumes:
      - "/docker/data/ipa-server:/app/upload"
3️⃣ Edit the environment variable

Replace the value of PUBLIC_URL with your own domain:

- PUBLIC_URL=https://apps.yourdomain.com
4️⃣ Run the server
docker compose up -d

That’s it! Your IPA & APK hosting server is now running at: 👉 https://apps.yourdomain.com

5️⃣ Point your domain

In your DNS settings, point your domain (or subdomain) to your server’s IP address. Once DNS is propagated, open the URL in Safari (iOS) or Chrome (Android) to install apps directly.


🔒 Optional: Use HTTPS

For iOS OTA installs, HTTPS is required. You can enable it using:

  • A reverse proxy like NGINX or Caddy
  • Free SSL certificates via Let’s Encrypt

💡 Example Use Cases

  • Internal distribution for QA/testing builds
  • Enterprise or in-house mobile app delivery
  • Hosting beta versions for your development team
  • Private app sharing without App Store / Play Store

🧠 Keywords

ipa server, apk server, ios ota install, mobile app distribution, self-hosted ipa server, android apk hosting, enterprise app deploy, app tester platform, internal app store


🧑‍💻 Author

Maintained by Hau Tran

Email: [email protected]

LinkedIn: https://www.linkedin.com/in/hautv/

Docker Image: hautvfami/ipa-server

My Products:

Tag summary

Content type

Image

Digest

sha256:ed479a781

Size

12 MB

Last updated

9 months ago

docker pull hautvfami/ipa-server:v1.4