Currently in Beta - View old docs

Installation for macOS

Step 1: Install Xcode

Download and install the latest version of Xcode from the App Store.

To verify your Swift installation, open a Terminal, enter the ‘swift’ command and pass the ‘--version’ flag:

swift --version

You should see something similar like this:

Apple Swift version x.x.x (LLVM ..., Clang ..., Swift ...)

If you see an error message, such as ‘swift: command not found’, you will need to install the Xcode Command Line Tools. Within the Terminal type:

xcode-select --install

Alternatively you can install Command Line Tools within Xcode:

  1. Open Xcode Preferences using the shortcut: `⌘ + ,`
  2. Click on the Locations tab.
  3. From the Command Line Tools drop down menu ensure the latest version of Xcode is selected.

Next steps

Create a Kitura server: Make use of SPM to create a server.

Optional: Install Kitura CLI

The Kitura Command Line Interface (CLI) provides a set of Command Line tools to simplify the creation of simple cloud ready applications. Simple commands allow quick and easy creation of starter Kitura projects without the need of writing any code.

We provide two ways of installing Kitura CLI, you can either install via Homebrew or npm:

Install via brew

For this installation you will need to have Homebrew installed.

If you do not have Homebrew installed you can follow the Homebrew installation steps

Install Kitura’s Homebrew tap to allow ‘brew’ to access Kitura’s package repository:

brew tap ibm-swift/kitura

Install Kitura’s command-line interface:

brew install kitura

Verify that Kitura CLI is installed by running:

kitura --version

If the installation was successful we would see information about the version.

Install via npm

For this installation method you need to have npm installed.

If you do not have npm installed you can follow the npm installation steps.

Open a Terminal and run the `npm install` command:

npm install -g kitura-cli

Verify that Kitura CLI is installed by running:

kitura --version

If the installation was successful we would see information about the version.

Next steps

Create a Kitura server: Make use of the Kitura CLI to create a server.

Optional: Install Kitura macOS app

The Kitura macOS app provides a user interface (UI) cover for the Kitura CLI. This option is designed for those who wish to avoid using the command line to create a simple cloud ready Kitura project.

Step 1: Download the macOS app

To download the macOS app click the button below:

Step 2: Install macOS app

Once the download has completed open `kitura.dmg`.

When the User Interface appears drag the Kitura icon into your applications folder:

Kitura macOS app install screen

Open the macOS Finder and find Kitura in the Applications folder.

When you first launch the app you may need to open it via the following:

  1. Right click on the Kitura application
  2. Select Open from the list

You will only need to open the app once this way. In future you can double-click as normal.

Upon opening the app you should see the following screen:

Next steps

Create a Kitura server: Make use of the macOS app to create a server.

Back to top