# Accounts & Application Management

# What is an account and what is it used for?

The account is a linux user which can be used simply to access the server. However, you probably want to deploy one or multiple applications under this user. This guide will explain how to deploy system users and all settings your application requires.

In the TurboStack App, you can create accounts in two ways: either by creating a brand-new account or by cloning an existing one.

# Creating a new account

# How to deploy a new account in the GUI

Creating a new user on the TurboStack App.

  • Open the TurboStack App
  • Open the server view
  1. Go to the Accounts page
    TurboStackNewUser
    TurboStackNewUser
  2. Add a new account (user)
    TurboStackNewUser
    TurboStackNewUser
  3. Give the account a name and save
    TurboStackNewUser
    TurboStackNewUser
  4. Save and Publish will deploy the change to the host
    TurboStackNewUser
    TurboStackNewUser

# How to deploy a new account in the source YAML Advanced

for more advanced users there also the YAML configuration. adding a new account can be done with

system_users:
  - username: prod

TurboStackNewUser
TurboStackNewUser

Now an account is created. Applications can be installed.

# How to create a new application

  • Open the TurboStack app
  • Click the host view
  • Select to host to update

# Prerequisite

Creating a new user on the TurboStack App. An account must exist before an application can be configured. How to create a new account

# Creating a new application in the GUI

Creating a new (default) application under the newly created prod user. Scenario: creating a Magento2 application, listening on www.example.com and using varnish as caching

  1. Open the detail section for the user
    TurboStackNewApp
    TurboStackNewApp
  2. Click to add a new application
    TurboStackNewApp
    TurboStackNewApp
  3. The first application for each user should always be default
    TurboStackNewApp
    TurboStackNewApp
  4. Go to Hostnames and 1 or more names the website should listen on
  5. Choose a website SSL certificate, there are 3 options: letsencrypt(default), self-signed and custom (3rd party certificate) (*)
    TurboStackNewApp
    TurboStackNewApp
  6. Go to Technologies and set the app type (**) that matches your application
  7. Enable PHP or another technology that your application requires
    TurboStackNewApp
    TurboStackNewApp
  8. Scroll down to enable varnish
    TurboStackNewApp
    TurboStackNewApp
  9. When going live, set a monitoring url so Hosted Power will monitor 24/7.
    TurboStackNewApp
    TurboStackNewApp
  10. Click Save to save and exit the configuration wizard.
    TurboStackNewApp
    TurboStackNewApp

Now the new application is configured, click Save & Publish to deploy the configuration to the server.

TurboStackNewApp
TurboStackNewApp
TurboStackNewApp
TurboStackNewApp

(*) Let's Encrypt certificates can only be validated of the selected hostnames already have the proper DNS settings to point them to the server. If this condition is not met, the validation will fail, and publishing will throw an error! If you cannot adjust DNS, but you do need HTTPS, you can choose a self-signed certificate and change it to Let's Encrypt whenever you're ready.

(**) The app type should match the CMS or framework that will be installed on this environment, and automatically applies some application-specific configuration. Can't find your CMS of framework in this list? Contact us!

# Creating a new application in source code mode (YAML) Advanced

For more advanced users there also the YAML configuration. adding a new application can be done with

system_users:
  - username: prod
    vhosts:
      - server_name: example.com www.example.com
        app_type: magento2
        php_version: "8.2"
        varnish_enabled: true
        cert_type: self-signed

TurboStackNewApp
TurboStackNewApp

# Cloning an account

To make a clone of an existing application, we provide the Clone Account feature. This function replicates the entire configuration and copies the files and database, enabling a quick and efficient setup with minimal effort.

Here’s how to do it:

  1. Navigate to the Accounts tab in the TurboStack App under your host.
    TurboStackNewUser
    TurboStackNewUser
  2. Click Clone Account.
    TurboStackNewUser
    TurboStackNewUser
  3. In the next step, select the source host. This can be either the current server or another server you manage.
    TurboStackNewUser
    TurboStackNewUser
  4. Choose the account you want to clone, then click Next.
    TurboStackNewUser
    TurboStackNewUser
  5. You'll be prompted to decide whether to copy the source account to an existing account or create a new account. Make your selection and click Next.
    TurboStackNewUser
    TurboStackNewUser
  6. Select the hostname(s) you'd like to associate with the account and choose the type of certificate you want to activate. Click Next to finalize.
    TurboStackNewUser
    TurboStackNewUser

And that’s it! Your application is now cloned to a new account. Be sure to save the configuration and publish it when you're ready.