Anchor
DownloadPrereq DownloadPrereq

Prerequisites

To get started, you will need:

1. Java - see Install Java JDK
2. A computer with a connection to the internet
   • Note: See Setting Aspire with No Internet Access (Offline) if this is not the case.

We also strongly recommend:

• Maven command-line - see Install Maven Command Line

Anchor
Downloads Downloads

Downloads

There are two ways you can download Aspire:

1. Downloading a pre-built distribution.
2. Using the Aspire Maven Distribution Archetype

Anchor
basic basic

Method 1: Basic Method Download with Pre-Built Binaries

A pre-built distribution of Aspire can be downloaded from https://wiki.searchtechnologies.com/binaries/

This distribution contains pre-built binaries for a functioning Aspire installation which works for both Windows and Linux.

Once you have downloaded Aspire, do the following:

1. Extract the contents of the zip or tar file into a directory
2. Edit and save the setting.xml file in the /Conf directory to change the default settings for username and password

   1. Code Block
      language xml
      <remoteRepositories> <remoteRepository> <id>stPublic</id> <url>http://repository.searchtechnologies.com/artifactory/simple/community-public/</url> <user>YOUR ASPIRE ACCOUNT USERNAME</user> <password>YOUR PASSWORD</password>d> </remoteRepository> </remoteRepositories>

3. Open a command prompt and set your current directory to the directory where you put the Aspire Software
4. Launch Aspire
5. Windows: bin\startup.batLinux: bin\startup.sh
6. Go to http://localhost:50505 in a web browser to get started

See Launch Control for more details.

Anchor
advanced advanced

Method 2: Advanced Method with Maven and the Aspire Distribution Archetype

We understand that it requires a little more effort (it requires the Maven command-line tool, and there are a couple of extra steps), however it has added flexibility including:

• The ability to build distributions for computers without an internet connection
• The ability to build multiple distributions for multiple environments (e.g. development, staging, QA, and production environments)
• The ability to bundle your applications

For complete instructions, see Quick Start with Distribution Archetype.

Anchor
upgrade upgrade

Upgrade to a Later Version

If you've chosen to upgrade to a later version, the instructions for changing your distribution to use it are here.

Method 2: Advanced Method with Maven and the Aspire Distribution Archetype

We understand that it requires a little more effort (it requires the Maven command-line tool, and there are a couple of extra steps), however it has added flexibility including:

• The ability to build distributions for computers without an internet connection
• The ability to build multiple distributions for multiple environments (e.g. development, staging, QA, and production environments)
• The ability to bundle your applications

For complete instructions, see Quick Start with Distribution Archetype.

Upgrading to a later version

If you've chosen to upgrade to a later version, the instructions for changing your distribution to use it are here.