Project Settings
Configure project-level preferences, rename your project, manage defaults, and perform high-impact lifecycle operations from the Project Settings page.
The Project Settings page is where you control the top-level configuration of a project. Changes made here apply to the project as a whole — not to individual apps or databases. Only project Owners and Admins can access or modify these settings.
What You Can Configure
Name & Display
Rename the project. The updated name propagates immediately across the Console, including the sidebar, breadcrumbs, and monitoring views.
Project ID
The immutable identifier assigned to this project at creation. The project ID is used in API calls, CLI references, and internal routing. It cannot be changed.
Project Defaults
Review and update project-wide defaults such as deployment region, default resource sizing, and runtime preferences. Defaults apply to new resources created inside the project; they do not retroactively change existing apps or databases.
Danger Zone
High-impact operations — project archival and deletion. These actions are irreversible. Read the warnings carefully before proceeding.
Renaming a Project
Open the Project
Open the project in the Console.
Navigate to Settings
Navigate to Project > Settings.
Update the Name Field
Find the Name field and enter the new name.
Save the Change
Save the change. The new name is reflected everywhere in the Console immediately.
Renaming a project changes how it appears in the Console but does not change the project ID, internal DNS names, or service hostnames. Running apps and databases are not affected.
Danger Zone
The settings page surfaces high-impact operations in a clearly marked section to prevent accidental execution:
Archival — archives the project and pauses all running services. Archived projects stop incurring compute costs but retain all data and configuration. An archived project can be restored.
Deletion — permanently deletes the project, all apps, all databases, all environment variables, and all associated data. This operation is irreversible. All running services are stopped and all persistent storage is wiped.
Deletion is permanent and cannot be undone. Ensure you have exported any data you need before deleting a project. There is no recovery path after deletion is confirmed.
To perform a dangerous operation:
- Navigate to Project > Settings > Danger Zone.
- Read the warning and confirm you understand the consequences.
- Type the project name to confirm the operation (as prompted).
- Execute the action.
Access Control
Project Settings is accessible only to Owners and Admins. Members and Viewers cannot view or modify project-level settings.
For access management, see Team Members.
Related
- Team Members — manage who can access and modify this project.
- Project Overview — full overview of the project structure and all resources.
- Create a Project — start a new project from scratch.
How is this guide?
Env Variables
Define and manage environment variables at the project level to share configuration across multiple apps, or scope variables to a single app for service-specific settings.
Overview
Apps are the individually deployable services inside a Skytells project — web servers, APIs, workers, schedulers, and Compose-based multi-service workloads, each running as an isolated container.