UPVALE / GUIDES
Team and account
Manage organization roles, invitations, sign-in sessions, your profile, and account security.
On this page
Organization settings control who can manage your resources. Your profile controls your own name, sign-in security, and date preferences.
Create an account and sign in
If account registration is available, enter your name, organization name, email, and a password of at least 12 characters on Create your account, then select Create account. Open the verification email and follow its button. For a paid plan, this takes you straight to checkout. For Free, it opens the sign-in page with a verification success message. Accounts that need administrator approval must wait for approval before continuing.
Verification links expire after 48 hours. For an unfinished paid signup, the original link opens checkout again, including in another browser. Once setup is complete, sign in normally. If you have not verified your email before the link expires, use Resend verification email. If registration is disabled, contact Upvale for access. Checkout keeps your selected package. Use Change plan to choose another package or billing interval. Free signup does not require payment.
Sign in with your email and password, or use a connected sign-in provider. If two-factor authentication is enabled, enter your authenticator code or a recovery code when prompted. Your organization is created during signup. An invited user joins the organization through the invitation and does not need to create one.
Sign in with Google, GitHub, or Microsoft
Choose Continue with Google, Continue with GitHub, or Continue with Microsoft on the sign-in or registration page. Only enabled providers appear.
For a new account, complete Name, Organization name, and Email on Complete your account, then select Create account. A verified email supplied by the provider is filled in and cannot be changed here. If email verification or administrator approval is still needed, follow the instructions shown. Your selected plan carries through to checkout.
If you already have an Upvale account, sign in as usual first, then connect the provider under Profile → Connected accounts. Matching email addresses do not automatically connect accounts. Once connected, the provider button signs you into your existing Upvale account.
Choose an organization
Open the account menu and use the Organization selector if you belong to more than one organization. Workloads, clusters, secrets, roles, and audit records belong to the selected organization. You can have different roles in different organizations.
Check the selected organization before inviting someone or changing infrastructure. Switching organization does not change your personal sign-in account.
Settings tabs
Open Settings in the sidebar:
| Tab | What you can do |
|---|---|
| Overview | See the organization name and your role. |
| Billing | See the package and usage. Organization Administrators can manage subscriptions, payment details, and invoices. |
| Roles | Create and edit roles and choose the permissions they grant. Requires Manage team. |
| Members | Manage active members and pending invitations in one place. Requires Manage team. |
| Sessions | Review your own sign-in sessions and sign out other devices. |
Plan usage distinguishes used capacity from reserved capacity. Pending work or invitations can reserve capacity before it is fully used. A limit shown as Unlimited has no numerical cap in that package.
Manage your plan
Open Settings → Billing. Members with View subscription can see the current plan and usage. Only organization Administrators can manage payments.
To change a paid plan or switch between monthly and yearly billing, choose the new option and preview the change. Review the charge or account credit, next renewal amount, and date before confirming. The change takes effect immediately. If your usage exceeds the smaller plan's limits, reduce it first.
To return to Free, select Free under Change plan or choose Switch to Free. You keep the paid plan until the date shown, then switch to Free with no further renewal charge. Existing workloads and billing history are kept. Choose Keep paid plan to undo the switch before it takes effect.
Use the payment-method action to update your card in Paddle Checkout. The payment history lists this organization's transactions and provides invoices when available. Each organization has its own subscription, even if you manage several organizations with one account.
Create a role
- Open Settings → Roles → New role.
- Enter a Role name and an optional Description.
- Select the permissions the person needs.
- Select Create role.
- Assign the role to an existing member or use it when sending an invitation.
The fixed organization Administrator role has all organization permissions. Custom roles can be edited or deleted. Move assigned members to another role before deleting their role.
Roles apply across the selected organization, rather than to an individual project. Editing a role changes the permissions of every member assigned to it in that organization. It does not change their roles in other organizations. Cluster VPN grants separately control which networks a member can reach.
You can grant only roles and permissions your own role is allowed to grant. The dashboard hides unavailable choices. Resource management permissions include the monitoring permission needed to view those resources.
Permission reference
| Permission | Allows |
|---|---|
| View monitoring | View dashboards, resource state, metrics, and operational status. |
| View logs | Read and download application, database, and scheduled-job logs. |
| Manage workloads | Create, edit, and remove projects, applications, and scheduled jobs. |
| Manage deployments | Deploy, roll back, start, stop, and restart workloads. |
| Manage databases | Create, configure, repair, restore, upgrade, and remove databases. |
| Manage nodes | Enroll, update, change, clean, and remove nodes. |
| Manage infrastructure | Manage clusters, networking, ingress, registries, and storage destinations. |
| Manage privileged workloads | Configure and operate workloads using host binds, Linux capabilities, or kernel settings. |
| Manage secrets | Create, rotate, use, and remove stored secrets; access database credentials and protected workload configuration. Generic secret values remain write-only in the Secrets screen. |
| Access terminals | Open interactive node and workload terminals. Other resource permissions may also be required for the target. |
| Access file manager | Browse, upload, download, edit, and remove files on nodes. |
| Manage Traefik | Read and change cluster Traefik configuration files. |
| Connect to developer VPN | Manage personal VPN devices for clusters where access has been granted. |
| Manage developer VPN | Choose gateways, define allowed network access, grant access, and manage VPN devices. |
| Manage alerts | Configure alert rules and notification channels. |
| View audit log | Read organization audit events and actor details, when the package includes audit logs. |
| Manage team | Manage roles, invite and remove members, and assign roles. |
| View subscription | Read the organization's package, limits, and usage. |
Permissions can work together. For example, creating a database requires database management and secrets access, while deploying a Compose definition requires workload, secrets, and deployment permissions. The relevant feature guide lists its requirements.
A role controls Upvale actions; it does not create database users or grant SQL permissions inside a database.
Invite a team member
- Open Settings → Members → Invite.
- Enter the person's Email.
- Choose their Role.
- Send the invitation.
- Check Pending invitations for the destination, role, and expiry.
Open the email's invitation button. If Set password and join appears, enter and confirm a password, then sign in; this also applies to an account that has only used social sign-in. Otherwise, sign in to the existing account and select Accept invitation. Use the Upvale account with the email address that received the invitation.
Resend or revoke an invitation
Use Resend next to a pending invitation to send a fresh link. The new email replaces the old invitation link; ask the person to use the latest message. Resending also renews the invitation expiry.
Use Revoke if the invitation is no longer needed. This prevents the pending invitation from being accepted. It does not remove someone who has already joined; use the active-member removal action for that.
If an invitation fails, check its email address and expiry, the organization's available user capacity, and whether your role can grant the selected role.
Change or remove an active member
In Members → Active members, choose a different value in the member's Role selector to update their role. Use the remove action to remove their membership from this organization.
Removing a membership does not delete the person's account or their memberships elsewhere. Upvale prevents removal or reassignment of the last active organization Administrator.
Removing a member permanently revokes their VPN grants and devices in this organization and deletes the stored device keys. The same happens when a role change removes Connect to developer VPN, or when you remove that permission from a role: in the latter case, it affects every member assigned to that role. Adding membership or permission back does not restore those credentials. Grant cluster access again, then have the person create new devices and import new configurations.
For a temporary pause, use Disable on the person's cluster VPN grant instead. See Pause or revoke VPN access.
For a developer who needs database connectivity without infrastructure management, create a small role with Connect to developer VPN and only the other permissions they need. Separately grant access to the relevant cluster and network destinations. See Developer VPN for the complete setup; a VPN permission alone does not grant access to every cluster.
Review sessions
Open Settings → Sessions to see the browser, source IP, sign-in time, and expiry for your sessions. The current session is marked current.
Use a row's revoke action to sign out that other session, or select Sign out other sessions to keep only the session you are using. This page shows your sessions, not every member's sessions.
Update your profile
Open Profile from the account menu.
| Field | What it changes |
|---|---|
| Shows the account email; it is read-only here. | |
| First name, Last name | Updates your profile name. |
| Timezone | Uses the browser's timezone or a selected timezone for displayed dates and times. |
| Date and time format | Chooses the display format, with a preview. |
Select Save profile after editing. Display timezone preferences do not change a scheduled job's configured timezone.
The Developer VPN card opens your personal VPN access page, where you manage your devices and connection files for granted clusters.
Connect or disconnect a sign-in account
- Open Profile → Connected accounts.
- Select Connect beside Google, GitHub, or Microsoft.
- Sign in with the provider and return to Upvale. The connected account appears in the card.
Use Disconnect to remove that provider as a sign-in method. Keep another connected, enabled provider or set a password first; Upvale prevents removal of your last available sign-in method.
If asked to sign in again, do so and return to Connected accounts. Connecting or disconnecting a provider signs out your other Upvale sessions; your current session stays open.
Set or change your password
If you registered with a provider and have no password, open Profile → Password → Set a password. Enter your Upvale account email, select Send reset link, then follow the email to choose a password of at least 12 characters. Select Update password and sign in again. The reset signs out all sessions; your connected sign-in accounts remain available.
Under Password, enter your current password, new password, and confirmation. Select Change password. Other signed-in sessions are revoked after a successful change.
If you cannot sign in, use Forgot password on the login page and follow the reset link sent to your account email. For an unused invitation, open the invitation link and complete password setup instead. If the link expired, ask the inviter to resend it.
Enable two-factor authentication
Set an Upvale password first if your account currently uses only social sign-in.
- Open Profile → Two-factor authentication → Enable 2FA.
- Enter your current password and select Continue.
- Scan the QR code with an authenticator app, or enter the manual setup key in that app.
- Enter the current authenticator code and select Enable 2FA.
- Save the recovery codes somewhere you can access if you lose the authenticator.
Future sign-ins require an authenticator code or a recovery code after your password or connected provider sign-in. A provider's own security settings do not replace Upvale's two-factor check. Recovery codes are single-use. The profile shows how many remain.
New recovery codes requires your password and an authenticator or recovery code. The new set replaces the previous set. Disable 2FA also requires your password and an authenticator or recovery code.
Theme and navigation
Upvale initially follows your system's light or dark appearance. Use the theme button to select the other appearance; that choice is remembered by the browser.
The header search finds resources in your current organization. Favorites keep frequently used projects and resources close at hand. The documentation link opens these guides from the control plane.
For operational records, see Monitoring, alerts, and audit.