-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the StackStudio wiki!
You can run StackStudio a few different ways.
- AWS AMI QuickStart to quickly try out StackStudio with Amazon Web Services
- Vagrant Install for development and for ready access to private clouds
- Install on a Server for a custom install on your own platform
StackStudio requires a set of backend services to operate: these services reside in the CloudMux project, available in the CloudMux repo. Follow instructions in that project to install and configure CloudMux.
StackStudio is a HTML5 application; beyond CloudMux, all StackStudio requires is a web server to serve up the HTML, CSS, and Javascript. The README describes a simple web server using Node.JS. You may also choose to serve StackStudio using Apache or Nginx or the web server of your choice. The root of the StackStudio project should be set as the document root for the server (or the virtual host); by convention, we use 9001 as the server port, but you can use any port.
StackStudio does need to access CloudMux, and as a HTML5 app, it must access it from the user's browser. You must create the "backend.json" file in the StackStudio root with a valid URL to CloudMux, as described in the README, and the URL must be accessible from the browsers on which StackStudio will be running (e.g., the DNS name must resolve, CloudMux ports must be open on a firewall).
As an alternative to the full install, you can follow the AMI QuickStart steps below to get a sense of StackStudio.
For a rapid introduction, try spinning up a pre-built Amazon AMI with StackStudio and CloudMux pre-installed and ready-to-run. This is not configured for production usage, but it will give you a feel for StackStudio.
To launch the quickstart,
- Launch an Amazon instance (t1.micro will work) with this image ID: "ami-fdd88a94"
- Ensure the instance is launched in a security group with inbound access on ports 9001 and 9292.
- When the instance starts up, browse to: http://{instance-public-DNS-name}:9001
- Click "Login" and choose "Register" to create a new account; choose a username and password
- Log in with the new credentials
- Choose "Cloud Credentials" -> "Create Credentials" and enter your Amazon public and private key (these are only stored on the instance)
- Navigate to Cloud Management and enjoy StackStudio!
You can also add additional public cloud accounts and credentials to the quickstart instance, as long as connectivity is available from the Amazon instance.