View source for Orion/How Tos/Install Orion on Localhost

This page explains how to download, install, and run Orion on your local machine. 

== Downloading Orion  ==

#Download Orion for your platform from the [http://download.eclipse.org/orion/ download page]. Choose the most recent Stable Build. 
#Unzip the zip file to a folder on your computer.<br>'''Note:''' Be sure to choose a folder that you have write access to.<br> '''Mac OS X:''' use the command line unzip. If you use the "Archive Utility", make sure that you "''Allow Applications Downloaded form: Anywhere''" in (System Preferences-&gt;Security &amp; Privacy-&gt;General)

== Starting the server ==
# Make sure you have Java installed - the server is implemented in Java and '''requires''' Java SE 6. (Does 'java -version' print something like: java version "1.6.0_22"?). You also need a modern HTML5-capable browser. We recommend Firefox 15 or greater, Chrome 21 or greater, or Internet Explorer 10 or greater.
# Launch the Orion server:
#* '''Linux:''' Run <code>eclipse/orion</code>.
#* '''Mac OS X:''' Double-click <code>eclipse/orion</code>.
#* '''Windows:''' Double-click <code>eclipse\orion.exe</code>.<p>Once you launch the Orion server, the server console should start.</p>[[Image:Orion_Console.png|Orion Server Console]]
# Now the server is running on port 8080. (If you want it to use a different port, change the setting in the orion.ini file. On Mac OS X, you will have to right-click on eclipse/eclipse and select "Show Package Contents", then navigate into Contents/MacOS.)
# Point your web browser to [http://localhost:8080/ http://localhost:8080/].
# You'll be directed to the Orion login screen:<br/>[[Image:Orion_Create_Account.png|Orion Login Screen]]<br/>From here you can create a new account for yourself on your local Orion server, or connect Orion to an existing Google or Mozilla Persona account instead (both these two options require an initial Orion account).

== Stopping the server ==
# Go to the server console window that opened when you launched the server.
# Type <code>close</code> and press Enter.


= Using Orion =
== Getting started ==
After you've got Orion installed and running, read [[Orion/Documentation/User Guide/Getting started | Getting started with Orion]] for a brief tour of the user interface and basic features.

== Linking to existing content ==
You can try out Orion's text editing features by editing existing files on your computer. 

# Configure the allowed local paths the Orion server can access. See the [[Orion/Server_admin_guide#Configuring_paths_where_users_can_store_files| Server administration guide]] for details on how to configure what directories are available to the Orion server.
# Log in and click the "Link Folder" button on the toolbar.
# Type in a name for the link, and in the '''Server path:''' field, enter the path to the folder you want to link to (it must be a subdirectory of one of the paths you supplied in Step 2). 
# Click OK.
# You should now be able to browse and edit the contents of the folder from the Orion UI.

<!--
== Managing files and folders ==
'''From the table view:'''
* To create a new folder, click the '''New Folder''' button on the toolbar.
* To create a new file, first drill into a folder by clicking on its name.
** Then you'll see the '''New File''' button appear on the toolbar. Click it to create a new file in the folder.
* To start editing a file, click its name.

'''From the tree view:'''
* To create or delete files or folders, right-click an item in the tree and use the context menu.
* To start editing a file, click the icon beside its name.

== Searching ==

== Adding favorites ==

== Using the JavaScript development tools ==
-->


[[Category:Orion/How To|Running]][[Category:Orion|Running]]