CFTS Documentation
Edge Portal Client Operations Guide
Client-facing version: 2026-06-09
1. Start Here
The CFTS Edge Portal lets approved clients view and operate their assigned edge or VPS services.
The portal is permission-based. You will only see the services and actions approved for your account.
This means that a missing button, console option, service, or power action does not automatically mean something is broken. In most cases, it means the action is not available for your account, your network, or the current service state.
The most important rule
Use the least disruptive action that can solve the problem.
Hard power actions, such as Hard power off or Hard reboot, should only be used when:
- graceful options are unavailable,
- graceful options have already failed, or
- CFTS has instructed you to use them.
When in doubt, stop and contact CFTS support before taking a disruptive action.
2. What You Can Do in the Portal
Depending on your account permissions, you may be able to:
- Sign in and view your assigned services.
- Check power state, uptime, guest tools, IP addresses, and resource indicators.
- Open a browser-based service console.
- Power on, shut down, or restart a service.
- Use recovery actions such as hard power off or hard reboot.
- Change your own portal password.
- Manage allowed or blocked source networks.
- Review your own login history.
- Keep account notes and to-do checklists.
- Export notes as Markdown.
The portal does not provide normal client access to CFTS internal administration, provisioning, billing, backup administration, firewall administration, snapshot management, or direct host management.
3. Why Something May Be Missing
If you expected to see a service, button, console option, or action but it is not visible, one of these usually applies:
| What is missing | Common reason |
|---|---|
| A service | The service is not assigned to your account, or it is no longer visible to the account. |
Actions menu |
Your account may be view-only, or no actions are valid for the current state. |
Console |
Console access is not enabled for your account or service. |
Shutdown or Restart |
The service may be offline, guest tools may not be running, or the operating system may not support graceful actions. |
Power on |
The service may already be online, or the action is not enabled. |
Hard power off or Hard reboot |
Recovery actions may not be enabled for your account. |
| Account settings | The feature may not be enabled for your account or current session. |
| Source network settings | Your account may not be allowed to manage its own network rules. |
CFTS support can confirm whether a missing item is intentional.
4. Browser Requirements
Use a current desktop browser such as:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
- Safari
Your browser must allow:
- cookies,
- JavaScript,
- HTTPS access to the portal,
- secure web socket connections if you use the console.
If the dashboard loads but the console does not connect, your company network may be filtering web sockets or browser scripts.
5. Signing In
- Open the portal URL supplied by CFTS.
- Enter your assigned username.
- Enter your assigned password.
- Select Login.
After a successful login, the dashboard opens automatically.
If login fails
Check the following:
- The username and password are entered exactly as supplied.
- You are connecting from an approved network, if your account is network-restricted.
- The account has not been disabled or blocked.
Do not send your password to CFTS by email, chat, screenshot, or ticket.
6. Understanding Your Account Access
Each client receives one or more approved portal accounts from CFTS.
Different accounts can have different access levels. Your account may combine one or more of these profiles:
| Profile | What it usually allows |
|---|---|
| View-only | View assigned services, power state, IP addresses, uptime, guest tools status, and resource indicators. |
| Standard operations | Use normal power actions such as Power on, Shutdown, or Restart when available. |
| Console-enabled | Open an in-browser console for assigned services. |
| Recovery-enabled | Use fallback actions such as Hard power off or Hard reboot after confirmation. |
| Network-restricted | Sign in only from approved public IPs, offices, VPNs, or client networks. |
These are not ranks. They are operational permissions.
7. Dashboard Overview
The dashboard is the main client operations screen.
At the top of the dashboard, you may see:
- your signed-in username,
- your detected client IP address,
- IPv4 and IPv6 display controls,
- account settings,
- notes or to-do access,
- theme control,
- logout.
Below this, each assigned service appears as a service card.
A service card can show:
- service display name,
- underlying service name,
- vCPU, memory, and storage allocation,
- VM uptime and operating system uptime,
- power state,
- operating system category,
- guest tools status,
- guest IP addresses,
- CPU, memory, disk, and network indicators,
- an Actions menu, when operations are available.
If your account has no visible assigned services, the dashboard shows:
No services are available for this account.
8. Common First Checks
Before using a power or recovery action, check:
- Is the service Online or Offline?
- Are guest tools running?
- Is an IP address visible?
- Is the dashboard updating normally?
- Can you open the console, if available?
- Are users or applications still active?
- Is the missing action expected for your account permissions?
If these checks do not explain the issue, contact CFTS before using hard recovery actions.
9. Dashboard Refresh and Time Display
Service cards refresh automatically about every 30 seconds.
The page does not fully reload. Values update in place.
Automatic refresh may pause while:
- the browser tab is hidden,
- an action menu is open,
- another refresh request is already running.
Dashboard refresh does not count as user activity for the inactivity timeout. You must actively use the portal to keep your session alive.
Updated time
The footer shows an Updated HH:MM value. This time is supplied by the Edge Portal server.
For the current Edge Portal, server-local time is East Africa Time.
HTTP headers, browser developer tools, and proxy logs may show UTC or GMT. That is normal and does not mean the portal clock is wrong.
10. Reading Service Status
Power state
| Label | Meaning |
|---|---|
| Online | The service is powered on. |
| Offline | The service is powered off. |
| Suspended | The service is suspended at the platform layer. |
| Service not found | The assigned service could not be found or is not visible to the account. |
| Unknown | The platform did not return a usable state. |
A service can be Online even if the guest operating system inside it is not responding normally.
Use power state together with console access, guest tools status, IP address status, and support guidance.
Operating system and guest tools
The portal may identify the service as Windows, Linux, Other, or Unknown.
Guest tools are services installed inside the guest operating system. They help the platform report IP addresses, operating system uptime, and whether graceful shutdown or restart is available.
| Guest tools label | Meaning |
|---|---|
| OK | Guest tools are running normally. |
| Running | Guest tools are running. |
| Update available | Guest tools are present but should be updated. |
| Not running | Guest tools are installed but not currently running. |
| Not installed | Guest tools are not installed. |
| Not supported | Guest tools are not supported for this guest. |
| Unknown | The platform did not return a usable tools status. |
Graceful Shutdown and Restart require the service to be online, guest tools to be running, and the guest operating system to be Windows or Linux.
11. IP Address Display
The dashboard shows guest IP addresses reported by the platform and guest tools.
By default:
- IPv4 addresses are shown,
- IPv6 addresses are hidden.
Use the IPv4 and IPv6 controls at the top of the dashboard to choose which address families are visible. Your preference is saved in the browser.
Use the copy control beside a visible IP address when you need to paste it into another tool.
If IP addresses show as unknown
Common causes include:
- guest tools are not installed,
- guest tools are not running,
- the guest operating system is still booting,
- the guest network is not configured,
- the platform has not refreshed the guest information yet.
Contact CFTS support if an IP address remains unknown and you need it for operations.
12. CPU, Memory, Disk, and Network Indicators
The dashboard can show platform-observed indicators for:
- CPU,
- memory,
- disk I/O,
- network I/O.
Use these as quick operational signals. They can help you spot obvious activity, inactivity, or pressure.
They are not a full guest operating system performance report, process list, application monitor, billing statement, or SLA measurement.
13. Service Actions
Each service card may include an Actions menu.
Only actions that are both approved for your account and valid for the current service state are shown.
| Action | When it is usually available | What it does |
|---|---|---|
| Console | Console access is enabled and the service is visible. | Opens an in-browser console for the service. |
| Power on | The service is offline and the action is enabled. | Starts the service. |
| Shutdown | The service is online, guest tools are running, the OS is supported, and the action is enabled. | Requests a graceful operating system shutdown. |
| Restart | The service is online, guest tools are running, the OS is supported, and the action is enabled. | Requests a graceful operating system restart. |
| Hard power off | The service is online and recovery fallback is enabled. | Forces power off after confirmation. |
| Hard reboot | The service is online and recovery fallback is enabled. | Forces a platform reset after confirmation. |
Recommended action order
Use this order whenever possible:
- Check the console or application first.
- Use Shutdown or Restart for normal maintenance.
- Use Power on only when the service is offline.
- Use Hard power off or Hard reboot only as a recovery fallback.
Hard fallback actions bypass the guest operating system. They can interrupt active users, corrupt unsaved work, or worsen an application issue.
14. How to Perform Common Actions
Power on a service
- Find the service card.
- Open Actions.
- Select Power on.
- Wait for the task to complete.
- Watch the dashboard for the state to change to Online.
The guest operating system and applications may need more time after the platform reports the service as online.
Gracefully shut down a service
- Confirm users and applications are ready for shutdown.
- Find the service card.
- Open Actions.
- Select Shutdown.
- Wait for the task to complete.
- Watch the dashboard for the state to change to Offline.
If Shutdown is not visible, the service may be offline, guest tools may not be running, the guest OS may not support graceful actions, or your account may not have permission.
Gracefully restart a service
- Confirm users and applications are ready for restart.
- Find the service card.
- Open Actions.
- Select Restart.
- Wait for the task to complete.
- Watch the dashboard while the service restarts.
Restart may temporarily interrupt console access, IP reporting, and application availability.
Hard power off
Hard power off is a recovery fallback.
Use it only if graceful shutdown is unavailable, has failed, or CFTS has instructed you to use it.
- Confirm graceful shutdown is unavailable or has failed.
- Find the service card.
- Open Actions.
- Select Hard power off.
- Read the confirmation page.
- Select Hard Power Off to proceed, or Cancel to return.
- Watch the dashboard for the state to change to Offline.
Hard reboot
Hard reboot is a recovery fallback.
Use it only if graceful restart is unavailable, has failed, or CFTS has instructed you to use it.
- Confirm graceful restart is unavailable or has failed.
- Find the service card.
- Open Actions.
- Select Hard reboot.
- Read the confirmation page.
- Select Hard Reboot to proceed, or Cancel to return.
- Watch the dashboard while the service resets.
15. Web Console
The web console gives browser-based keyboard, mouse, and screen access to an assigned service.
Open the console
- Find the service card.
- Open Actions.
- Select Console.
- The console opens in a new browser tab or window.
- Click inside the console screen to focus keyboard and mouse input.
Console toolbar controls
| Control | Purpose |
|---|---|
| Connection status | Shows whether the console is connecting, connected, disconnected, or in error. |
| Paste Text | Sends text from your browser into the guest console. |
| Ctrl Alt Del | Sends Ctrl Alt Del to the guest operating system. |
| Fullscreen | Requests fullscreen console display. |
| Reconnect | Reloads the console session. |
| Disconnect | Disconnects the console session. |
| Power actions | Shows available service power actions when allowed. |
Paste Text is one-way input only. It does not create a shared clipboard and cannot copy text, screenshots, or files from the guest console back to your browser.
Review pasted text before sending it. Pasted text goes wherever the cursor is focused inside the guest operating system.
Console access is live access to the service. Any keyboard, mouse, operating system, or application changes take effect immediately.
If the console does not connect
Try the following:
- Wait a few seconds for the connection status to update.
- Select Reconnect.
- Refresh the console tab.
- Confirm your browser or company network allows secure web socket traffic.
- Confirm the service is still visible and assigned to your account.
Contact CFTS support if the console reports Console unavailable, Console SDK unavailable, Console error, or remains disconnected.
If keyboard input does not appear to work, click inside the console screen first.
16. Account Settings
Account settings are available from the header when enabled for your account.
They may include:
- your signed-in username,
- your detected client IP address,
- password change controls,
- allowed and blocked source network controls,
- recent login history for your own account.
These settings apply only to the signed-in account. You cannot view or change another client's account settings from this area.
Change your password
- Open account settings from the header.
- Enter your current password.
- Enter the new password.
- Confirm the new password.
- Submit the change.
If the change fails, the portal may show a safe reason, such as a password policy issue. Choose a stronger password and try again.
Do not reuse weak, old, shared, or easily guessed passwords.
Source network rules
Some accounts can manage their own allowed and blocked source IP or CIDR rules.
Allowed source networks define where the account may sign in from. Blocked source networks deny access from specific IPs or ranges.
Examples:
203.0.113.10
203.0.113.0/24
Important behavior:
- Rules apply only to the signed-in account.
- Blocked rules take priority over allowed rules.
- If allowed rules exist, the account should sign in only from those networks.
- The portal prevents saving a rule set that would block your current detected IP.
- Office, VPN, or ISP address changes may affect access.
Contact CFTS support before changing source rules if you are unsure which address or range to use.
Login history
Account settings can show recent login history for the signed-in account.
Use it to confirm successful, failed, or denied sign-in activity. It includes detected client IP, result, and timestamp.
If you see activity you do not recognize, change your password if possible and contact CFTS support.
17. Notes and To-do Lists
The portal can provide account notes and to-do lists from the header.
Use this area for short operational notes, maintenance reminders, handover points, and task checklists linked to the signed-in account.
Notes are account-owned. One client account cannot view another account's notes through the portal.
The notes area may support:
- New note for general text notes,
- New checklist for task-style entries,
- nested notes up to three levels deep,
- collapsed note rows,
- search across note titles, bodies, and checklist text,
- Markdown export.
Good examples
Patch window agreed for Friday 18:00 EAT.
Check backup status after reboot.
Confirm application owner has tested login.
Follow up with CFTS about missing IPv6 address.
Do not store secrets in notes
Notes and to-do lists are not a password manager, secrets vault, legal record system, or secure document store.
Do not store:
- passwords or password hints,
- API keys,
- private keys,
- tokens,
- recovery codes,
- backup passphrases,
- full third-party credentials,
- unnecessary personal data.
Notes are stored on the portal server and may be included in server backups. CFTS administrators or operators with server access may be able to inspect stored notes during support, security, or recovery work.
Markdown exports leave the portal and become your responsibility to protect.
18. Theme Control
The portal includes a theme control in the header when available.
Changing the theme affects only the portal appearance in your browser. It does not change the service itself and does not affect other users.
19. Signing Out and Session Timeout
Use Logout in the header when you are finished.
Always log out before:
- leaving a shared workstation,
- closing a support session,
- handing the browser to another person.
Authenticated sessions expire after a period of inactivity. The default timeout is up to 15 minutes, although CFTS may configure a shorter timeout.
User activity such as clicking, typing, scrolling, or touching the page can keep the session alive.
Passive dashboard refresh does not keep the session alive.
If the session expires, the portal redirects you to logout or asks you to sign in again. Any open console session should be considered disconnected after timeout.
20. Common Messages
| Message | What it means | What to do |
|---|---|---|
| Session expired | Your session timed out. | Sign in again. |
| Service not found | The service is not visible to your account or no longer exists under that name. | Contact CFTS if unexpected. |
| Action not allowed | Your account, service state, or security policy does not permit the action. | Check status and permissions; contact CFTS if needed. |
| Platform connection failed | The portal could not reach the backend platform. | Try again later; contact CFTS if it continues. |
| Task failed | The requested task did not complete successfully. | Do not repeatedly retry without understanding the cause. |
| No services are available for this account | Your account currently has no visible assigned services. | Contact CFTS if this is unexpected. |
| Password change failed | The platform rejected the password change or password policy. | Choose a stronger password or contact CFTS. |
| Notes can only be nested 3 levels deep | The note is too deep in the tree. | Move it higher or update an existing note. |
21. Security Expectations
All portal users must follow these practices:
- Keep credentials private.
- Do not share portal accounts.
- Do not send passwords in tickets, email, chat, or screenshots.
- Use only approved networks if your account is network-restricted.
- Be careful when changing source network rules.
- Do not store secrets in notes, to-do lists, or exported Markdown files.
- Log out when finished.
- Report unexpected services, missing services, or suspicious activity to CFTS.
- Treat console access as direct access to the service.
Portal action attempts, login events, and account self-service events may be logged with timestamp, username, client IP, result, and a short message.
This protects clients and CFTS by creating a traceable operational record.
22. When to Contact CFTS
Contact CFTS support when:
- you cannot sign in,
- your assigned service is missing,
- you can see a service you should not see,
- guest IP is unknown and you need the address,
- guest tools show not running, not installed, or unknown,
- a required action is missing,
- a power action or console connection fails,
- you need a hard fallback action enabled or performed,
- you are unsure how to set allowed or blocked source networks,
- you see login history you do not recognize,
- a password change fails and the displayed reason is unclear,
- note saving or Markdown export fails,
- the visible portal Updated time does not match expected server-local time,
- you suspect a security issue.
Include this information in support requests
Please include:
- portal username, but not the password,
- service display name or service name,
- time and date of the issue,
- browser used,
- action attempted,
- error message shown,
- whether you were using dashboard, console, account settings, source network rules, or notes,
- your source office, VPN, or public IP if network restriction may be involved.
Screenshots are helpful, but remove or avoid sensitive passwords, tokens, unrelated client information, or confidential data before sending them.
For suggestions, bug reports, or support requests, contact:
devops@cfts.co
23. Client Operation Checklist
Use this checklist for normal operations:
- Sign in with your assigned account.
- Confirm only expected services are visible.
- Check service power state, guest tools, IP address, uptime, and resource indicators.
- Use IPv4 or IPv6 filters as needed.
- Use account settings only for your own password, source network rules, and login history.
- Use notes for operational reminders, not secrets.
- Use the least disruptive available action.
- Use console only when direct screen access is required.
- Confirm the service returns to the expected state.
- Log out when finished.
If anything looks wrong, stop and contact CFTS support before taking disruptive recovery actions.
24. One-page Quick Reference
If a service is offline
- Confirm it is the correct service.
- Open Actions.
- Use Power on, if available.
- Wait for the dashboard to show Online.
- Allow extra time for the guest operating system and applications to start.
If a service is online but not responding
- Check guest tools status.
- Check IP address status.
- Check CPU, memory, disk, and network indicators.
- Open the console, if available.
- Use graceful Restart only if appropriate.
- Use hard recovery only if graceful recovery is unavailable, has failed, or CFTS instructs you to use it.
If an action is missing
- Check service power state.
- Check guest tools status.
- Check whether the operating system supports the action.
- Check whether your account is expected to have that permission.
- Contact CFTS support if still unclear.
If the console will not connect
- Wait briefly.
- Select Reconnect.
- Refresh the console tab.
- Check whether your browser or network blocks secure web sockets.
- Contact CFTS if the issue continues.
If you see suspicious login history
- Change your password if possible.
- Do not share screenshots containing passwords or secrets.
- Contact CFTS support.