Skip to content
ForgeVPS

Browse guides

Find your way around

Learn what ForgeVPS does, what each tab is for, and how the different parts of your workspace fit together.

Connect or install ForgeVPS

Choose hosted or self-hosted, connect your machine, and open your first workspace.

Use the Dashboard

Check the machine you are working on, understand its resource readings, and find your next step.

Browse and edit files

Find your project, edit and save code, search files, and understand the Workspace and Git controls.

Use the Terminal

Run commands on your machine, keep separate tasks in tabs, and return to sessions you left open.

Use the Servers tab

Add an app, choose development or production, and use the list and detail controls to keep it running.

Deploy from GitHub

Connect a repository, follow its build, and publish later changes by pushing to the selected branch.

Give your app a web address

Point a domain at your machine, choose the app it should open, and check that HTTPS is working.

Use the Databases tab

Create a PostgreSQL database, open tables, edit rows, run a query, and connect your application.

Import a Supabase database

Copy selected application schemas into a new local database, verify the result, and switch your app deliberately.

Back up and restore a database

Use the Backups dialog to save a recovery point, download a copy, and restore when you need to.

Work with an agent

Give your agent a reliable starting point without handing over credentials or changing your project's instructions.

Technical reference

Understand the panel, managed processes, workspace files, and the boundary between ForgeVPS and your applications.

Open app ↗
Browse documentation
Docs/Use the Dashboard

Use the Dashboard

Check the machine you are working on, understand its resource readings, and find your next step.

Hosted & self-hostedReviewed 2026-09-29Read as Markdown ↗
On this page

Open your machine’s overview

Select a machine, then open Dashboard. This page describes the VPS as a whole. The memory reading here includes more than your application: databases, background services, the operating system, and the self-hosted panel also use resources.

Use the machine name and connection information to confirm you are in the right workspace before working on an application. A working panel page and a reachable machine are separate things; hosted ForgeVPS can load even when its SSH connection to your VPS has a problem.

Read the resource cards

  • Disk tells you how much storage is in use. Application files, dependencies, database data, logs, and backups all take space.
  • Memory shows pressure across the machine. If it stays close to full, compare it with individual applications in Servers.
  • CPU load helps you spot busy periods. Builds and imports can raise it temporarily; a sustained change is more useful than a single reading.

A missing reading means the panel has not obtained that information. It does not mean the machine is using zero resources. Check the connection and any displayed error before drawing a conclusion.

Finish setup when prompted

If Dashboard shows unfinished setup, open the setup controls and follow the remaining steps. Some features need services on the machine before they can be used. A new, empty VPS and an existing server can therefore show different setup work.

  1. Read the name of the unfinished or failed step.
  2. Run or retry the setup action offered by the panel.
  3. If it fails, open the Setup log and read the latest error.
  4. Return to the tab you wanted to use after the required setup completes.

Understand the Sessions area

The Sessions area shows terminal activity on the machine. It can help you find a task you left running. Opening Terminal gives you the full interactive session; the Dashboard is an overview rather than another shell.

A quiet session may simply be waiting for your input. Check its terminal output before deciding that it has stopped working.

Use the right tab for the problem

  • A single app is slow or stopped: open Servers, check that app’s status and memory, then read its Logs.
  • A folder appears to use too much space: open Files, right-click it, and choose Storage usage….
  • The app works at its direct address but not at its domain: open Domains and check the address and target.
  • Several tabs cannot load machine data: check the machine connection first.