# Installation

If you got familiar with saaster, and you would like to use it for a real life application, we recommend using a clean installation of saaster. 

First check if your host meets these [system requirements](https://docs.saaster.io/getting-started/system-requirements).

For developers there is a guide to setup a local development environment:

{% content-ref url="../development/local-development" %}
[local-development](https://docs.saaster.io/development/local-development)
{% endcontent-ref %}

## Get saaster

Download the latest version from GitHub. Either get the official [latest release](https://github.com/PAWECOGmbH/saaster/releases) or clone the [repository](https://github.com/PAWECOGmbH/saaster/releases).

In the majority of cases we recommend to work with the official version because it is well documented and has undergone many error tests.

In this guide, we assume that you have downloaded the latest release. (.zip file)

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td>           Latest release (recommended)</td><td></td><td><a href="https://github.com/PAWECOGmbH/saaster/releases">https://github.com/PAWECOGmbH/saaster/releases</a></td></tr><tr><td></td><td>                              Repository</td><td></td><td><a href="https://github.com/PAWECOGmbH/saaster">https://github.com/PAWECOGmbH/saaster</a></td></tr></tbody></table>

## Configure website

Create a new website with your chosen web server and unpack all files into the root directory of this website. Running saaster in a subdirectory should in theory be possible, but is not officially tested.

Check out the example web server configurations under [system requirements](https://docs.saaster.io/system-requirements#web-server).

When you created your new website and copied all files, you need to make some changes to the `config.cfm` file. You will find a template of this file in the `configs` folder. Please copy this file into the root directory and rename it to `config.cfm`.

Set these values accordingly to your website configuration:

```cfscript
// Environment
variables.environment = "prod";

// Enter the URL of your live project (incl. http:// or https://)
variables.mainURL = "https://www.your-domain.com";

// The name of your application.cfc
variables.applicationname = "YourProjectName";
```

## Create database

{% hint style="info" %}
For the datasource you must set "Allow multiple Queries" to *true*
{% endhint %}

Create a new MySQL database and add a new datasource in the Lucee Administrator. Following that task, execute the SQL scripts located in `/db/init/`. You can find more information about the database structure here.&#x20;

Also set the name of the newly created datasource in the `config.cfm` file:

```cfscript
variables.datasource = "database";
```

## Further configuration

These basic configurations should be enough to get saaster running. We recommend to set all other settings / values  in the `config.cfm` file to your liking. \
\
This guide will help you to complete the configuration of saaster.

{% content-ref url="configuration" %}
[configuration](https://docs.saaster.io/getting-started/configuration)
{% endcontent-ref %}

## Running the setup routine

After you finished the installation of saaster, we recommend running the setup routine of saaster.

{% content-ref url="setup-routine" %}
[setup-routine](https://docs.saaster.io/getting-started/setup-routine)
{% endcontent-ref %}