# Application Manager

The Stadium Application Manager enables you to manage key [server](#stadium-application-manager-sam) and [application](#application-management) settings.

***

## Stadium Application Manager (SAM)

Access server management features from the Applications screen and from the server menu at the top of the screen.

#### Upload a new Application load a new application file to Application Manager.

**Steps:**

1. On the Applications screen, click the Upload Application button.
2. Select your application file to upload.
3. Select your application's *Authentication* method.
   * *Email & Password*\
     Users will log in to your Application with their email address and password.
   * *Single sign-on*:\
     Users will log in via the Authentication service that they are registered with: Auth0, Okta or Azure AD.
   * *None*\
     Users will not be required to log in and will have access to all [*Pages*](https://docs.stadium.software/features/pages) in your Application.
4. Create your application's *Admin User*:\
   (An Admin User is a user that can access an application's administration features, i.e. maintaining user roles and users.)
   * When Authentication is *Email & Password*:\
     Provide Email, Password and a display Name.
   * When Authentication is *Single sign-on*:\
     Provide your Email and Name, as registered with your Authentication service provider.
   * When Authentication is *None*:\
     No Admin User will be created.
5. If required, edit your application's *Connections* and *Settings*. (The values of "secret" settings will be blank; provide values now, or[ later](#application-management) on Application Manager.)
6. Click the Create Application button.

   <figure><img src="https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-a00cdaabc06b2935935b98e12dc618ce8c1195a2%2Fapplication-manager-upload.png?alt=media" alt=""><figcaption></figcaption></figure>

*Note:* As an alternative to uploading an application from within Application Manager, it is also possible to [publish an application](https://docs.stadium.software/features/publish) from within Stadium Designer.

***

### Server Configuration

Provide your SMTP (email) details from where password reminders will be sent to users who have forgotten their passwords. When SMTP details are added, a 'Forgot Password' feature will automatically be added to all your generated applications, as well as for *Application Manager*.

**Steps:**

1. Select *Configuration* from the Server menu item (at the top of the screen).
2. Provide your email settings: *From Address, SMTP Server, SMTP Username, SMTP Password, SMTP Port*.
3. Click the Save Settings button.

### Maintain Users

Add, update or delete Application Manager users. (Note: These users are not your applications' Admin Users.)

**Steps:**

1. Select *Users* from the Server menu item (at the top of the screen).
2. Click the Add User button.
3. Provide the *Email, Password* and *Name* of the user.
4. Click the Save button.

***

### Application Management

To access the Application Management features, first select your Application on Application Manager.

#### Connections

The connection details of the *Connector*s (Database, web service or file system) that are part of your application.

**Steps:**

1. Select Connections from the menu on the left.
2. Click on the value of the applicable connection to edit.
3. Click the Save icon.

#### Settings

The details of the Settings that are part of your application.

**Steps:**

1. Select Settings from the menu on the left.
2. Click on the value of the applicable setting to edit.
3. Click the Save icon.

*Note:* If a setting was set to "secret" in Stadium Designer, and not updated when the application was uploaded / deployed, the value of the setting will be blank on Application Manager and will have to be provided here.

#### Configuration

Set the maximum file size of any upload performed on your application.

**Steps:**

1. Select Configuration from the menu on the left.
2. Enter the maximum upload file size in MB.
3. Click the Save button.

#### Authentication

Determine whether users must log in to gain access to your application and select how logins will be authenticated.

**Steps:**

1. Click the Authentication menu item.
2. Select the applicable Authentication method:

   * *Email & Password*:\
     Users will log in to your Application with their email address and password.
   * *Single sign-on*:\
     Users will be required to log in via the specified Authentication service: Auth0, Okta or Azure AD.\
     Go [here](https://docs.stadium.software/how-it-works/single-sign-on-authentication) for help on how to set up Single sign-on authentication.
   * *None*:\
     Users will not be required to log in and will have access to all [*Pages*](https://docs.stadium.software/features/pages) in your Application.

   <figure><img src="https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-b3e2ef22d11c5ad0f4ca2c82f884979539ba87c7%2Fauthentication.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Debug Mode

To switch on debug mode so that users of the application can see detailed error messages. This is not a good user experience or safe, and should only be switched on for debugging purposes, after which it should be switched off again.

**Steps:**

1. Click the Debug Mode menu item.
2. Switch the Debug Mode On / Off.

#### Generate an API key

Generate an API key to allow fetching, adding or updating users via a REST webservice.

**Steps:**

1. Click the User API menu item.
2. Click the Generate New Key button.

More on the [User API](https://docs.stadium.software/how-it-works/user-api)

#### Update History

Your application's update history.

**Steps:**

1. Select Update History from the menu on the left.
2. Update history is displayed.

#### Delete Application

To delete your application from Application Manager. (This will not delete your application file from your machine. The application file will still be available to open with Stadium Designer or to re-upload to Application Manager.)

**Steps:**

1. Select Delete Application from the menu on the left.
2. Enter the name of the application.
3. Click the Delete button.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stadium.software/how-it-works/application-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.