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.

app-distribution-server logo

Self-host app-distribution-server

v2.1.1

Self-hosted iOS/Android app distribution for IPA and APK

ReleaseOpen SourceGPL-3.0
Updated5 months ago
LanguagePython
Setup difficultyEasy
Stars
165
Port
8000 (HTTP server for upload and installation pages)
Docker
ghcr.io/significa/app-distribution-server
Install with Docker
Site and usage preview showing the installation page with QR code

What is app-distribution-server?

app-distribution-server is a simple, self-hosted server for distributing iOS and Android mobile app builds (IPA and APK files). It provides a single upload endpoint secured with a pre-shared token, returning a public install page with a QR code for on-device installation. The server deploys via Docker and supports local filesystem and S3-compatible storage backends. It does not handle device registration or app building, focusing solely on file sharing for internal distribution among developers, testers, or clients. The project includes a Swagger/OpenAPI explorer at /docs for API documentation.

Should you self-host app-distribution-server?

app-distribution-server scores 45/100 on selfhost.directory (how scoring works) and ranks #11 of 20 in Application Management. It has 165 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is hot-updater (62/100, 1 797 stars). It scores higher overall, so compare the two before you pick. See app-distribution-server vs hot-updater side by side.

Features

  • Customizable Branding
  • IPA and APK file upload
  • Pre-shared token authentication
  • QR code installation page
  • S3-compatible storage backend
  • Swagger/OpenAPI documentation

app-distribution-server README

How to install app-distribution-server

Install app-distribution-server with Docker

Docker
Environment variables
UPLOADS_SECRET_AUTH_TOKEN, APP_BASE_URL, STORAGE_URL, LOGO_URL, APP_TITLE

docker run
-p 8000:8000
-v ./uploads:/uploads
ghcr.io/significa/app-distribution-server

Mount a local directory for persistent uploads storage.

How to configure app-distribution-server

  • APP_BASE_URLhttp://localhost:8000The front-facing app URL for link generation.

    The front-facing app URL for link generation.

    values: Any valid URL

  • APP_TITLEiOS/Android app distribution serverCustom page title for the installation page.

    Custom page title for the installation page.

    values: Any string

  • LOGO_URL/static/logo.svgThe logo URL - absolute URL or relative path to a logo src. Set to false to disable.

    The logo URL - absolute URL or relative path to a logo src. Set to false to disable.

    values: URL, relative path, or false

  • STORAGE_URLosfs:///uploads (Docker) or osfs://./uploads (Python)A PyFilesystem2 compatible URL for storage backend.

    A PyFilesystem2 compatible URL for storage backend.

    values: Any PyFilesystem2 URL (e.g., s3://bucket-name)

  • UPLOADS_SECRET_AUTH_TOKENsecretToken used to upload builds. Must be changed in production.

    Token used to upload builds. Must be changed in production.

    values: Any string

app-distribution-server releases & version history

More in Application Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…