# Unzip the zip file to a folder on your computer.<br/>'''Note:''' Be sure to choose a folder that you have write access to.

+

+

== 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 9 or greater.

# Now the server is running on port 8080. (If you want it to use a different port, change the setting in the eclipse.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.)

+

# 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.)

# You'll be directed to the Orion login screen:<br/>[[Image:Orion-M4-login.png]]<br/>From here you can create a new account for yourself on your local Orion server, or connect Orion to an existing Google, Yahoo, AOL or myOpenID account instead.

+

# 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 =

= 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 ==

== Linking to existing content ==

−

You can try out Orion's text editing features by editing existing files on your computer. Here's how:

+

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

−

# Open the <code>eclipse\eclipse.ini</code> file in a text editor.

+

−

# In the <code>-vmargs</code> section, add a line similar to this:

+

# 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.

−

#* <code>-Dorg.eclipse.e4.webide.server.allowedPathPrefixes=C:\Users\myusername\Documents\Code,C:\Myprojects\OrionFiles</code><br/>This sets the JVM system property <code>org.eclipse.e4.webide.server.allowedPathPrefixes</code>, which tells the Orion server what local paths may be accessed by web users. Its value is a comma-separated list of absolute paths. (Remember that any Orion user who logs into your server will have this access, so don't point it to something sensitive.)<br>''Note that this option has been renamed since M4 - if you are running the M4 download, use -Dorg.eclipse.e4.webide.server.allowedPathPrefixes=some_path, but when using later builds, use -Dorg.eclipse.orion.server.core.allowedPathPrefixes=some_path.''

+

# Log in and click the "Link Folder" button on the toolbar.

−

# Relaunch the Orion server.

+

# 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).

−

# Log in and click the "Link Folder" or "Link Project" button on the toolbar.

+

# Click OK.

−

# 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). Then click OK.

+

# You should now be able to browse and edit the contents of the folder from the Orion UI.

# You should now be able to browse and edit the contents of the folder from the Orion UI.

−

== Stopping the server ==

+

<!--

−

# Go to the OSGi console window that opened when you launched the server.

Contents

Downloading Orion

Download Orion for your platform from the download page. Choose the most recent Stable Build.

Unzip the zip file to a folder on your computer.Note: Be sure to choose a folder that you have write access to.

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 9 or greater.

Launch the Orion server:

Linux: Run eclipse/orion.

Mac OS X: Double-click eclipse/orion.

Windows: Double-click eclipse\orion.exe.

Once you launch the Orion server, the server console should start.

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.)

You'll be directed to the Orion login screen: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 close and press Enter.

Using Orion

Getting started

After you've got Orion installed and running, read 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 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.