LogoLogo
  • Introduction
    • 👋Overview
    • 🤷Target Audience
    • ✨Features
  • Getting started
    • 🖥️System Requirements
    • 📦Installation
    • ⚙️Configuration
    • 🔧Setup Routine
  • Fundementals
    • 🎎Roles
    • 🌏Countries and time zones
    • ♻️Scheduletask concept
    • 💰Payment Service Provider
    • ✏️Administration
      • 🔵Sales
        • 👥Customers
        • 📥Invoices
        • 📋Plans
        • 🧊Modules
      • 🟢System
        • 🎛️System settings
        • ⛓️API Settings
        • 🌐Languages
        • 🪙Currencies
        • 🏳️Countries
        • 📂Mappings
        • 💬Translations
        • 🪧Widgets
    • 🖱️User guide
      • 🔐Customer rights
      • 🔗Customer Navigation
      • 📃Edit profile
      • 🔑Reset password
      • 🏨Edit company
      • ⚡Manage users
      • 👔Manage tenants
      • 📨View invoices
      • 💸Add payment method
      • 🪧Manage plans
      • 📦Manage modules
      • 🔔Notifications
  • Development
    • 🛠️Local development
    • 📂Folder structure
      • 🗄️Application.cfc
    • 💡Develop with saaster
      • 🎇General services
        • 💼Mappings and rigths management
        • ↩️Redirects
        • 👤Customer specific sessions
        • 〽️Global variable "getCustomerData"
      • 🌐Global functions
        • ⚙️getTrans()
        • ⚙️getAlert()
        • ⚙️logWrite()
        • ⚙️getTime()
      • 🧊Developing the main application
      • 📦Developing modules
  • API
    • ⚒️API: Get started
    • 📂Resources
      • 📄authenticate
      • 📄getCurrentModules
      • 📄getCurrentPlan
      • 📄getPlanFeatureSetting
Powered by GitBook
On this page
  • Get saaster
  • Configure website
  • Create database
  • Further configuration
  • Running the setup routine
  1. Getting started

Installation

Instructions for installing saaster

PreviousSystem RequirementsNextConfiguration

Last updated 1 year ago

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 .

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

Get saaster

Download the latest version from GitHub. Either get the official or clone the .

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)

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 .

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:

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

For the datasource you must set "Allow multiple Queries" to true

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.

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

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.

Running the setup routine

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

📦
⚙️Configuration
🔧Setup Routine
system requirements
🛠️Local development
latest release
repository

Latest release (recommended)

Repository

system requirements