Linode (Akamai Cloud)
Deploy rtCloud on Linode using StackScripts with a form-based configuration UI.
Linode uses StackScripts — scripts with a form-based UI where you fill in configuration fields directly in the Linode Manager without editing any code.
Linode StackScripts are the easiest deployment method. Fields appear as a form when you create a Linode — no script editing required.
Embedded Keycloak (Recommended)
Step 1 — Find the StackScript
The StackScript is publicly available in the Linode community — no manual setup needed:
- Go to Linodes → Create Linode
- Under Choose a Distribution, select StackScripts → Community StackScripts
- Search for
RTA rtSurvey - Self-Hosted with Keycloak SSO - Select it and fill in the configuration form:
Alternatively, download the script and create your own StackScript under StackScripts → Create StackScript.
| Field | Required | Description |
|---|---|---|
| Project ID | No | Unique identifier (default: rtsurvey). Used as database name and Keycloak client ID. |
| Keycloak Admin Password | No | Password for both Keycloak admin console and app admin login. Defaults to admin — change after first login. |
| Domain | Yes | Your domain name. DNS A record must point to this Linode’s IP. Required for HTTPS and Keycloak. |
| Let’s Encrypt Email | Yes | Email for Let’s Encrypt certificate notifications. |
| Docker Image Tag | No | Image to deploy (default: rtawebteam/rta-smartsurvey:survey-dockerize). |
Security: All passwords default to
admin. Change them immediately after your first login.
- Choose Ubuntu 22.04 LTS as the image
- Choose Shared CPU 4 GB plan or larger
- Click Create Linode
Step 2 — Add the DNS record
While the Linode boots, add an A record in your DNS provider:
Type : A
Name : myapp (or @ for root domain)
Value : <linode-ip>
TTL : 300
Step 3 — Monitor progress
ssh root@<linode-ip>
tail -f /var/log/stackscript.log
The script prints your server IP near the start — add the DNS record as soon as you see it.
Step 4 — Access the app
When setup completes, the log shows a summary:
============================================================
rtCloud deployment complete! (Embedded Keycloak)
============================================================
App URL : https://myapp.example.com
Admin : admin / admin
Keycloak : https://myapp.example.com/auth/admin
!! SECURITY: All passwords default to 'admin'.
Change them immediately after first login.
============================================================
Log in with username admin and password admin, then change your password immediately.
After Deployment
Change a password
nano /opt/rtcloud/.env
docker compose -f /opt/rtcloud/docker-compose.production.yml up -d --force-recreate rtcloud
View all containers
docker compose -f /opt/rtcloud/docker-compose.production.yml ps
Check the log
tail -200 /var/log/stackscript.log