4. Running the Setup Wizard

Welcome to the Setup Wizard

To access the Crowd Administration Console and run the Setup Wizard, go to the URL http://localhost:8095/console or http://localhost:8095/crowd/console.

When accessing the Crowd Administration Console for the first time, you will be presented with the Setup Wizard which will prompt you for a set of default values. Note that all of these values can be adjusted later if required.

1. Licensing

Crowd licenses are based on the number of end-users who will login to one or more of the applications that are integrated with Crowd. Evaluation licenses may be obtained from the Atlassian website.

Screenshot 1: 'License'

2. Options

This part of the setup process controls the general options of the Crowd server.

Screenshot 2: 'Options'

The Deployment Title specifies a unique name for your Crowd instance. The Deployment Title can be used when sending email notifications.
The Domain is used when setting HTTP authentication cookies in a user's browser. If this attribute is not the correct, single sign-on will not work when the user switches between applications.
The Session Timeout controls how long a session will be considered valid during any period of inactivity. This is in minutes and must be greater than 0.

3. Mail Server

Crowd can send email notifications to users during special events such as when a password is reset.

Enter the details of your mail server, and the username and password (if required) that Crowd will use to log in to your mail server:

Notification Email — The email address which will receive notifications about server events.
SMTP Host — The hostname of the SMTP mail server, e.g. 'localhost' or 'smtp.acme.com'
From — The email address from which password notifications will be sent to users.
Subject Prefix — The prefix which will appear at the start of the email subject, for all emails generated by Crowd. This can be useful for email client programs that offer filtering rules.
Username — The username that your Crowd server will use when it logs into your mail server.
Password — The password that your Crowd server will use when it logs into your mail server.

Screenshot 3: 'Mail Server'

4. Default Directory

A default directory needs to be configured. For information about configuring different types of directories (Internal, LDAP or Custom) please see 2.2 Adding a Directory.

Screenshot 4: 'Default Directory'

The default group crowd-administrators will be automatically created in the default directory.

5. Default Administrator

A default Crowd administrator needs to be created. The default administrator will be automatically added to the default group crowd-administrators, thereby giving them rights to access the Crowd Administration Console.

Screenshot 5: 'Detault Administrator'

6. 'Demo' Application

An option to auto-configure the 'demo' application server is available to assist you with quickly setting up and configuring Crowd. It is recommended that you choose 'Yes'.

The 'demo' application highlights best practices for using the Crowd framework. The Crowd download archive contains the entire source for the 'demo' application, which can be used as an example when integrating your custom web applications.

Screenshot 6: 'Demo Application'

Setup Complete

You are now ready to use the Crowd Administration Console. For details, please see the Crowd Administration Guide.