A self-hosted platform-as-a-service that hosts web apps written in Java, Clojure, NodeJS, Python, golang, Scala and .NET Core. Designed to be simple to deploy behind a firewall, on corporate intranets or at home. Once running, tell App Runner the Git URL of a web app and it will automatically build and host it for you, with support to auto-deploy on every git push.
- Host your own Platform as a Service: you just need Java 8, plus optional build tools (Maven, Leinigen, Scala/SBT, go compiler, NodeJS/NPM, Gradle, Python 2 or 3, .NET Core SDK).
- Deploy web apps with no build servers or deploy scripts needed: tell AppRunner the Git URL and it will automatically build and host it.
- Auto deploy on source control change when using post-commit hooks
- Zero downtime deployment: when changes are being deployed, a new instance is built, tests are run, and the app is started. Only when the new instance is running will it be made live.
- An optional dashboard which links to all your apps making it easy to find, add, and deploy.
- Horizontally scale individual app runners across multiple machines with App Runner Router
App Runner is especially useful for people or teams who are creating many little web applications and want the convenience of a platform such as Heroku but cannot use an external service.
- 2.3.0 Breaking golang change: it now uses go modules. Also, the default branch no longer needs to be called
master - 2.2.0 Bug fixes, particularly the one where apps were sometimes not shutting down.
- 2.1.0 Added let's encrypt (and other ACME server) support for free HTTPS certs (see
sample-config.propertiesfor instructions) - 1.6.0 Added
GET/POST/DELETE/api/v1/apps/{name}/dataendpoints to manipulate an app's data directory. - 1.5.6 Added backup info to the apps API and added app name validation
- 1.5.4 Added optional config for handling proxy timeouts:
apprunner.proxy.idle.timeout(default 30000ms)apprunner.proxy.total.timeout(default 60000ms). - 1.5.1 Fixed bug where sometimes creating a new app it would say there are no suitable runners, even though there are.
Also added
lastBuildandlastSuccessfulBuildto theappAPI to provide information about when and what was built (the git commit info is included). - 1.4.0 Added a PUT
/apps/{name}method to change the GIT URL of an app, and made it soPOSTing an app to/appsthat already exists returns a 400 error. Also fixed the return type (toapplication/json) forPOST /apps. There is also--app-name=your-app-namepassed as a command line parameter to Node apps, mostly to aid in finding which app is which when looking at running processes. - 1.3.4 GoLang support
- 1.2.2 Support for HTTPS (see the sample config file for more info). This is also the first version that HTTPS can be used on the app runner router (or other reverse proxies).
- 1.1.0 Optional support for Scala and better reporting of versions of tools such as java, node, lein etc. When adding a new app, it is immediately cloned and an error is returned if it cannot be cloned or this instance does not support the project type.
- 1.0.7 Optional backup support: specify a Git URL in the config (
appserver.backup.url) to have the data directory backed up to a git repo once an hour.
Run com.danielflower.apprunner.RunLocal.main from your IDE. This will use the settings in
sample-config.properties. Upon startup, it will try to download, build, and deploy the
application specified in the config. Launch the URL that is logged on startup see the hosted
sample app.
You need to have a Windows or Linux server available with Java 8 or later and one or more build tools installed. One or more of Maven, Gradle, Leiningen, NodeJS with NPM, Scala with SBT, GoLang, Python 2 or 3.
It's easiest if each tool is available to run from the path, but you can point to specific paths by setting paths in your config file.
Download the latest version of App Runner from Maven central
Run with java -jar app-runner-{version}.jar /path/to/config.properties
See sample-config.properties for sample configuration. The local directory in this repo also
has sample start scripts and logging configuration.
You will also need to provide M2_HOME=/path/to/maven/home before you run source code and test cases.