Get Started with AppScale

AppScale can be deployed on a single node (usual case for Dev/Test), and on multiple nodes (production deployments with large datasets or CPU needs).

Step One: Set up AppScale on your infrastructure

AppScale on GCE

Required: A Google Cloud Platform account

1) Make sure you have a network suitable for AppScale (learn more)

2) Get the latest AppScale image (learn more)

3) Create a GCE instance of the latest AppScale image with at least 4GB of RAM (e.g. machine type: 2 vCPUs, 7.5 GB memory, n1-standard-2) using the AppScale network

4) Log into the GCE instance as root (learn more)

AppScale on AWS

Required: An AWS account

1) Make sure you have a network suitable for AppScale (learn more)

2) Start an EC2 instance of the latest AppScale AMI (default availability zone: us-east-1a) with at least 4GB of RAM (e.g. instance type: m3.large) using the AppScale network

3) Log into the EC2 instance as root (learn more)

AppScale on Docker

Required: Docker Engine

1) Pull the latest AppScale version by running:
docker pull appscale/appscale:latest

2) Start the container by running:
docker run -i -t appscale/appscale:latest /bin/bash

3) Go into the root home directory with:
cd /root

AppScale on Vagrant

Required: Vagrant and VirtualBox

1) Setup your Vagrant environment with the latest AppScale box by running:
curl -o Vagrantfile https://s3.amazonaws.com/appscale_CDN/files/Vagrantfile_template

2) Start your Vagrant virtual machine by running:
vagrant up

3) Log into the Vagrant virtual machine as root (learn more)

Building AppScale from Source

Required: Ubuntu Trusty machine with at least 4GB RAM

1) Log into your Ubuntu Precise or Trusty system as root (learn more)

2) Install AppScale by running:
wget -O bootstrap.sh http://bootstrap.appscale.com && bash ./bootstrap.sh

3) Once the build is finished, run:
. /etc/profile.d/appscale-tools.sh

Step Two: Start AppScale

These instructions are to setup a Dev/Test environment.

Once you are logged in as root, run the following command:
bash appscale/scripts/fast-start.sh --no-demo-app

Once the FastStart finishes, you will have a fully-functional AppScale Dev/Test deployment ready to run your applications.

Step Three: Deploy/Manage Application

AppScale comes with a sample application.
To deploy the sample app, run:
appscale deploy guestbook.tar.gz

To have the app served on the default HTTP and HTTPS ports, run:
appscale relocate guestbook 80 443

To remove the sample app, run:
appscale undeploy guestbook

That's it! Follow the same steps to deploy your own application.


Ready to become a pro?

Start AppScale the way you need it:

Customize AppScale
Want to learn more?

Find out more about what you can do with AppScale:

Deployment types

AppScale AdminGet Started with AppScale