Welcome!

If you are reading this, we'd like to thank you for your interest Aptana Studio. Please read through this guide carefully.

For Aptana Studio 2 Upgraders

Aptana Studio 3 is intended to be completely independent from Aptana Studio 2. You can install both Studio 2 and Studio 3 separately and run them both on the same machine, since they will use different workspace directories. If you wish to import your Studio 2 projects into Studio 3, you can follow instructions here.

Prerequisites

Before you install the Release, you should have the following tools installed and working correctly:

  • Sun/Oracle Java 1.5.x or later on Mac and Linux. OpenJDK is not yet supported. The Windows installer includes a compatible version of Java.
  • Git is required because it is used internally to update your scripting environment. On Windows, we recommend PortableGit from msysgit because we also require its bash shell for executing commands. If you don't have msysgit installed, Studio 3 will offer to install it for its own internal use.
  • If you are installing Studio 3 as an Eclipse plugin, you must use Eclipse 3.5 or better.

If you intend to do Ruby on Rails development, you will also need to set up your Ruby and Rails development environment:

  • Ruby 1.8.7+ and/or 1.9.1+ (on Windows, we recommend RubyInstaller along with its optional DevKit addon). You can use other ruby runtimes (e.g. jruby) if you like, but we expect to find ruby and gem tools on your path by name. Plus we haven't tested debugging with other interpreters yet, so debugging may not work if you use an alternate runtime.
  • Rails (2.x and/or 3.0)
  • The gem that supports the database(s) of your choice.
  • For debugging, you will need to have the ruby-debug-base and ruby-debug-ide gems installed.

You should also make sure that your login PATH is set up correctly such that you can execute the ruby, gem, rails, and git commands correctly. Setting these things up in your .bashrc (or equivalent) isn't sufficient, because it doesn't get evaluated by default when GUI applications like Aptana Studio 3 get launched.

Ruby switching utilities like rvm should also work, provided that you set them up in your login PATH as well.

If getting your login PATH set up in this way isn't practical for you, you can work around the problem by launching Aptana Studio 3 from the command line, using the studio3 command line utility. This utility can be found at the top level of the Aptana Studio 3 installation folder, so you can put that folder in your PATH for convenience. (The command line utility can also be called after Aptana Studio 3 is running, to get it to open source code files for editing.)

Update Your Installation Regularly

The IDE is configured to check for updates from our update site, and we plan on releasing new versions on a regular schedule.

Getting Started With Studio 3

Check the help system for links on geting started and how to use various features.

Providing Feedback and Reporting Bugs

  • Browse Discussions

    The active community around Aptana Studio includes documentation, Aptana communications and member conversations.
  • Bug Tracker

    Found a bug? Use our bug tracker to see the list of open and closed bugs as well as submit new tickets.

Release Notes

Getting Started Guides

On-demand deployment and management of your Ruby on Rails applications with Engine Yard Cloud.

Rock-solid Ruby platform. Deploy and scale with confidence. Free to Signup