Run Airship Launcher with Docker 🐳

AirshipCMS provides an easy way for developers using Docker to work on an AirshipCMS site.

View the Docker image details in the Docker.io registry: https://hub.docker.com/r/airshipcms/launcher.

The Airship command line tools ("Airship Launcher") provide developers a way to login and sync files between your local development environment and the Airship server. Airship Launcher also includes a local development server.

The following Docker host operating systems are supported:

  • OSX
  • Linux
  • Windows
  • WSL2 (Windows Subsystem Linux)

Running the Docker container

It is important to run the Airship Launcher docker container from your airship project directory.
If you don't have a project directory yet, create an empty directory and navigate to it in your terminal.

OSX

Navigate to your project directory

cd ~/Projects/my-airship-project

Use this command in your airship project directory when using OSX.

Run Airship Launcher with docker

docker run --rm -it \
  -v $PWD:/srv \
  -v ~/.airship-sessions:/home/.airship-sessions \
  -p 9800-9828:9800-9828 \
  -p 9001:9001 \
  airshipcms/launcher
Copied!

Linux

Navigate to your project directory

cd ~/Projects/my-airship-project

Use this command in your airship project directory when using Linux.

Run Airship Launcher with docker

docker run --rm -it \
  -v $PWD:/srv \
  -v ~/.airship-sessions:/home/.airship-sessions \
  -p 9800-9828:9800-9828 \
  -p 9001:9001 \
  airshipcms/launcher
Copied!

WSL (Windows Subsystem Linux 2)

Navigate to your project directory

cd ~/Projects/my-airship-project

Use this command in your airship project directory when using WSL.

Run Airship Launcher with docker

docker run --rm -it \
  -v $PWD:/srv \
  -v ~/.airship-sessions:/home/.airship-sessions \
  -p 9800-9828:9800-9828 \
  -p 9001:9001 \
  airshipcms/launcher
Copied!

Windows - PowerShell

Navigate to your project directory

cd Projects\my-airship-project

Use this command in your airship project directory when using Windows and PowerShell.

Run Airship Launcher with docker

docker run --rm -it `
  -v "$($PWD):/srv" `
  -v "$($PWD)\.airship-sessions:/home/.airship-sessions" `
  -p 9800-9828:9800-9828 `
  -p 9001:9001 `
  airshipcms/launcher
Copied!

Windows - Command Shell (cmd)

Navigate to your project directory

cd Projects\my-airship-project

Use this command in your airship project directory when using Windows and CMD.

Run Airship Launcher with docker

docker run --rm -it ^
  -v %cd%:/srv ^
  -v %cd%/.airship-sessions:/home/.airship-sessions ^
  -p 9800-9828:9800-9828 ^
  -p 9001:9001 ^
  airshipcms/launcher
Copied!

A detailed explanation of this command is available at github.com/AirshipCMS/Launcher#explanation


Using Airship Launcher in Docker

After executing the docker run command from the previous step, you should be in an interactive terminal in the running docker container.

The terminal prompt will look like this [🐳 Airship Launcher] $ when you are in the runinng docker container. This means that you can run all the airship commands. If you want to run other commands, such as git, open a new terminal session that is not using tho Airship Launcher docker container.

Interactive Airship Launcher Docker container session

Login to Airship CMS

In the Airship Launcher docker container, use airship login [subdomain] to authenticate with Airship CMS.

Logging in with the Airship Launcher Docker container

Start the Airship Server

In the Airship Launcher docker container, use airship serve to start a local server. While it's running, you can connect to it with your browser by navigating to http://localhost:9001

Logging in with the Airship Launcher Docker container

To stop the server in the running docker container, send the interrupt signal (SIGINT) by pressing CTRL + C. This will kill the listening process started by airship serve.

Exiting the Airship Launcher

To exit from the interactive Airship Launcher terminal in the running docker container, send the EOF by pressing CTRL + D or execute the command exit. This will exit the docker container and clean itself up. You may run the docker run command from the previous step again, to pick up where you left off.

Exiting the Airship Launcher Docker container


For more on airship commands check out Airship CLI Commands in the AirshipCMS Documentation. For a guided tutorial on using Airship CMS check out the Get Started Guide

Airship Web Deployment Platform

Command Line Tools

Fast Deployment

Fully-Hosted Files & Assets

Simple, Secure Content Management

No Credit Card Required.