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/Introduction

What is ForgeVPS?

ForgeVPS is a browser workspace for your VPS. It puts your terminal, files, applications, domains, and databases in one place so you can work on your server through a visual interface.

On this page

What you can do

Use ForgeVPS to build and run projects on a Linux machine. You might edit a website, run a coding agent in a terminal, host an API, or manage an application’s database. Your code and applications stay on your machine; ForgeVPS gives you the controls to work with them.

For example, you can open a project in Files, install its dependencies in Terminal, start it through Servers, and connect its address in Domains. These tabs work with the same machine.

Start with your machine

A machine is your VPS: the computer that provides storage, memory, and processing power. An entry in Servers is an application running on that machine. One machine can run several apps.

  • Hosted ForgeVPS: open the hosted app and connect your VPS over SSH. ForgeVPS runs the panel; your VPS runs your projects.
  • Self-hosted ForgeVPS: install the panel on your own machine, then open the address provided by installation. You work in that machine’s local workspace.

Already connected? Start with Find your way around. Otherwise, follow Connect or install ForgeVPS.

Find the right tab

Check the selected machine’s name, then choose the tab for what you want to do. Each guide walks through the controls you will see there.

TabUse it to…
DashboardCheck your machine’s memory, disk, CPU load, connection, and setup status.
TerminalRun commands, set up a project, or work with a command-line agent on the machine.
FilesBrowse folders, edit and save code, search a project, and review Git changes.
ServersStart an app and manage its process, logs, environment, and deployment settings.
DomainsGive a running app a web address and set up HTTPS.
DatabasesCreate a PostgreSQL database, browse tables, edit rows, run SQL, and manage backups.

Your first project

If your project is already on the machine, try this path:

  1. Open Files, find the project folder, and read its README.
  2. Open Terminal in that project’s directory and run the setup commands the project needs.
  3. Open Servers → Add server, choose Development server, and select the same folder and its start command.
  4. Check the server’s Logs, open the app’s address, and make sure it responds.
  5. Return to Files to edit and save your code. Your project’s development server controls whether changes reload automatically.

For a live app, choose Production server instead. On hosted ForgeVPS, you can also connect a GitHub repository and deploy changes by pushing to its configured branch.

Choose a task

Browse and edit filesFind your project, edit and save code, search files, and understand the Workspace and Git controls.Use the Servers tabAdd an app, choose development or production, and use the list and detail controls to keep it running.Give your app a web addressPoint a domain at your machine, choose the app it should open, and check that HTTPS is working.Use the Databases tabCreate a PostgreSQL database, open tables, edit rows, run a query, and connect your application.Back up and restore a databaseUse the Backups dialog to save a recovery point, download a copy, and restore when you need to.Import a Supabase databaseCopy selected application schemas into a new local database, verify the result, and switch your app deliberately.Work with an agentGive your agent a reliable starting point without handing over credentials or changing your project's instructions.