Deploy and Host AssppWeb on Railway

AssppWeb is an open-source, self-hosted web interface designed for acquiring and OTA-installing iOS apps outside the App Store. It utilizes a zero-trust browser-side architecture to interact directly with Apple APIs, providing a secure, independent package distribution solution for personal and development environments.

Preview

About Hosting AssppWeb

Hosting AssppWeb on Railway provides a reliable, single-container deployment backed by secure cloud storage. Railway builds the application directly from the published container image, exposes the required HTTP/WebSocket ports, and attaches persistent Volumes to preserve IPA packages and cache files across releases.

Since OTA iOS app installation requires a secure connection, Railway's automatic HTTPS domain provisioning simplifies the setup process. By deploying on Railway, you benefit from automatic GitHub deployments, logs, metric monitoring, and easy vertical scaling without operational overhead.

Dependencies for AssppWeb Hosting

Persistent Volume (required for caching downloaded packages and settings)
Public Domain with HTTPS (required for iOS OTA installation links)

Deployment Dependencies

GitHub Repository: https://github.com/Lakr233/AssppWeb
Docker Image: https://github.com/users/Lakr233/packages/container/package/assppweb
Official Documentation: https://github.com/Lakr233/AssppWeb#readme

Implementation Details

Recommended Railway Configuration

Setting	Value
Builder	Dockerfile
Dockerfile Path	Leave blank (uses image default)
Root Directory	Leave blank
Start Command	Leave blank
Public Networking	Enabled
Persistent Volume	`/data`
Environment Variables	`PORT`, `DATA_DIR`, and optional access controls

Recommended Environment Variables (include comments describing what each variable configures)

PORT=8080 # The container listening port
DATA_DIR=/data # Directory where package data and caches are stored
ACCESS_PASSWORD=your_secure_password # Optional password to protect the web UI and API
DOWNLOAD_THREADS=8 # Number of parallel download threads (usually 1-32)
AUTO_CLEANUP_DAYS=7 # Delete cached IPA files older than this many days (0 to disable)
AUTO_CLEANUP_MAX_MB=0 # Delete oldest cached files when storage exceeds this limit in MB (0 to disable)
MAX_DOWNLOAD_MB=0 # Reject downloads larger than this limit in MB (0 to disable)
PUBLIC_BASE_URL=https://your-railway-domain.up.railway.app # The public base URL of the deployed app

Common Use Cases

Self-host an independent app library to sign and install iOS apps OTA.
Store and distribute development IPA packages securely outside the App Store.
Relay Apple API requests safely using AssppWeb's built-in zero-trust structure.

✨ Features

💯 Free & Open Source
🔒 Zero-Trust Browser-side Architecture
🌐 Built-in Web Dashboard
📦 Persistent Package Storage
⚡ Multithreaded Downloads
🧹 Automated Cache Cleanup
🛡️ Optional Password Protection
🔌 WebSocket Relay Support (/wisp/)

Why Deploy AssppWeb on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying AssppWeb on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.