/Kitura-Starter-Bluemix

Kitura-based server starter application for Bluemix.

Primary LanguageSwiftApache License 2.0Apache-2.0

Kitura

Mac OS X Linux Apache 2 Join the chat at https://gitter.im/IBM-Swift/Kitura

Bluemix starter application for Kitura web framework

Summary

Kitura-Starter-Bluemix is a Kitura based server application that you can use as a starting point to get your own Kitura application up and running on Bluemix. After cloning this GitHun repo to your local syste, you can deploy this application to Bluemix right away. If you'd also like to run Kitura-Starter-Bluemix locally, then see the instructions for installation on OS X or installation on Linux for details on system level dependencies you may need before attempting to execute this app.

Clone, build, and run

  1. Clone this repo using git clone https://github.com/IBM-Swift/Kitura-Starter-Bluemix.git and go to the root folder using cd Kitura-Starter-Bluemix. Please do not use the GitHub Download ZIP button as a way to clone this repo.

  2. Compile and execute the server app using: make run. Once the server starts, you should see the message Listening on port 8090. The executable file is located in the .build/debug directory: ./.build/debug/Kitura-Starter-Bluemix.

  3. Open your browser at http://localhost:8090.

  4. Access static content using the following URL:http://localhost:8090/static.

Pushing to Bluemix

You should have the Cloud Foundry command line installed on your system and you should be already logged on to Bluemix before you attempt the following steps.

  1. From the root folder of this repo on your local system, execute cf push.

  2. Once the application is pushed to and running on Bluemix, you can access your application route to see Kitura's welcome page on your browser.

Swift version

This version of Kitura-Starter-Bluemix works with the DEVELOPMENT-SNAPSHOT-2016-05-03-a version of the Swift binaries. You can download this version of the Swift binaries by following this link. Compatibility with other Swift versions is not guaranteed.

Kitura Wiki

Feel free to visit our Wiki for our roadmap and some tutorials.

License

Kitura-Starter-Bluemix app is licensed under Apache 2.0. Full license text is available in LICENSE.