Getting Started

Top  Previous  Next

To start using Girder first we'll need to start the application. On the start menu you'll find "Girder Local" or "Girder Remote". To understand the difference we'll need to know a bit about the way Girder works.


Girder is made up out of two main parts. The back-end and the front-end. The back-end is where most of the work is done for Girder. This is where all the automation takes place, it's the brain of the two. The front-end is the part that interacts with you. It's the user-interface. These two parts are completely separate and can run on completely different machines. Of course they do not have to run on different machines in fact they can run inside the same process.


To run Girder as one process, meaning the back-end and the front-end run at the same time on the same machine select "Girder Local". This is probably a good place to start. Below are the various methods of running Girder:

Run in one process

This is the "Girder Local" option from the start menu. This means that the back-end and the front-end are both running in the same process. Stopping the front-end will stop the back-end as well. Note that you can set the front-end to run in the tray bar. This is the way Girder 5 ran.

Run in service

This runs the Girder back-end as a service on your machine. It starts up with your computer and runs until the computer is turned off. If not already done you'll have to register the service. To do this you'll need to start "Girder Remote" as administrator by right clicking the start menu and selecting "run as administrator". The click on the "Local Network" tab and find the "Girder Service Settings..." button. There press the "Install Service" button. You can also start it from that dialog.


Note that when running Girder as a service, Girder is using a different set of configuration files from the Girder instance that is running in process. The reason for this is that configuration settings are stored on a per user basis. The service based Girder is running as the service users ( Local System ).

Front-end connect to service

Connect to it using the "Girder Remote" option on the start menu. This will open the "Local Network" tab on the Girder connection dialog. If the service has been started you should see the computer name listed here. By default the password is "girder".

Front-end connect to remote Girder anywhere

If your remote Girder instance is not showing up in the "Local Network" tab use the "Internet" tab to connect. Here you must enter the IP address, port number and password to connect.

Secure Connections

Girder supports SSL encryption of the communications. To use this simply select "Secure Connection". Special version of Girder can be requested that perform full SSL certificate verification.

What next?

Now that you have Girder up and running the next step is to learn about the basic actions and events concepts in Girder and then to walk through a tutorial.