Skip to content
User guide

Project settings

The eight groups of Project > Settings: general, runtime, secrets and env, domains and health, resources, automation, access and the danger zone.

Open a project and click the Settings tab. The settings are in eight groups listed on the left; each card saves on its own with its own button.

General

  • Description: shown on the project card and to your team.

  • Size: the CPU and memory it gets (Extra small to Extra large). Greyed out if your organisation sets sizes for you.

  • Type: set when the project was created; shown, not changed.

  • Docs: the project's own documentation page.

Click Save changes.

Runtime

  • Containers: extra containers the project started on its own network, such as a scratch database or a helper. Run a container with a Name (scratch-db), an Image (redis:7), a Command and Variables (NAME=value, one per line).

  • Sub-apps: containers your app starts for itself. Each takes its parent's CPU and memory limits until you set its own.

  • Mounts: file shares the project reads, from a mount.txt in the repository.

Secrets and env

  • Environment variables: plain settings as name and value rows. Click Save environment; the next deploy or restart uses them.

  • Secrets from the Vault: click Pick from the Vault to bind a secret or a bundle. The project receives each one as an environment variable; the value is never shown in the console or the logs. See Vault and secrets.

Domains and health

The card Domains, routing and health check ("Its address, who must sign in, and how REM CloudHub knows it is up"):

Setting

What it does

Health check path

A path that answers 200 when the app is healthy, such as /health

Every (seconds), Waits (seconds), Tries before down, Start-up grace (seconds)

How often it is checked and when it counts as down

Requests per second and Burst

A rate limit; above it, callers get 429

Allowed addresses

One address or range per line. Empty: anyone

Sign-in required

People sign in with REM CloudHub before they reach it

Strip the path prefix

The project sees / instead of its address path

Test health check tries it now; Save routing saves. Below, Idle policy can Pause when idle after a time you choose, and Alerts sets this project's own alert thresholds.

Custom domains (your own host name instead of remcloudhub.com/your-project) are set up by the platform team for your organisation. Write to support@remplatforms.com with the host name; once the DNS record points at REM CloudHub, a certificate is issued automatically.

Resources

Databases, caches, storage, keys and services the project gets before it starts, and what its code still needs. REM CloudHub reads the code on each deploy and attaches what it asks for. Check now reads it again; Attach what it needs or Apply now binds the missing pieces; Detach removes one. Attach my own secrets binds your own secrets where the code asks for a name you hold.

The AI key card: the project's own key for the AI gateway. Click Issue the key; it arrives as QCH_AI_KEY on every deploy and nobody pastes it anywhere.

Automation

Auto-update decides how new commits reach the project:

How it updates

What happens

Off

Only when someone clicks Redeploy or Update now

Push

Your git host calls the Webhook address with the Webhook token on every push to the branch

Poll

REM CloudHub checks the branch How often you choose

Roll back by itself: when the new version fails its health check, the version before runs again. Project jobs lists the jobs that run this project's code.

To set up push: copy the Webhook address and the Webhook token (click New token for a fresh one) into your repository's webhook settings, with the token in the X-QCH-Webhook-Token header. Pushes to other branches are ignored.

Access

Who can see it: personal, one team, several teams or the whole organisation. People and teams lists who was given access and until when. Give access to a person or group with a role and an optional end date; the note you add is shown to them and in Activity. Transfer hands the project to a new owner.

Danger zone

"Actions here cannot be undone from this page." Delete project stops it and detaches its databases and files, which are kept.

Download: PDF · Word · Markdown

Project settings | REM CloudHub docs · REM CloudHub