Docs /
... / Configuration / Rename a project and manage its servers

Rename a project and manage its servers

Manage a project's display name and server assignments from Project Settings at app.odac.run. You can rename how the project appears in your dashboard, choose which attached server is the Default deploy target for new apps, and assign additional servers to the project.

Open Project Settings

  1. Click the gear icon (Project Settings) at the bottom of the left sidebar rail on any project page (Canvas, Domains, DNS Settings, or Mail Accounts). Hovering over the icon displays the Project Settings label.

Left sidebar rail on the Canvas with the pointer hovering the Project Settings gear icon and showing the Project Settings tooltip

  1. You can also open Project Settings from the top-left header. Hover over or click the active project name next to the ODAC logo to expand the project menu, hover over the active project (or any other project in the list), and click the gear icon on the right side of its row (see Projects and navigation).

Top header project menu expanded with the pointer hovering the settings gear icon next to shop

  1. Project Settings opens on the Settings tab, showing Rename Project and Danger Zone on the left and Servers on the right. Use the Activity tab in the header card to review project-wide changes or Danger Zone to delete the project (see View project activity and delete a project), or click × in the top-right corner of the header card to return to the Canvas.

Project Settings page on the Settings tab showing Rename Project, Danger Zone, and Servers

Rename a project

  1. In the Rename Project card, click the project name field (pre-filled with your current project name, placeholder e.g. My First Project) and enter a new display name between 2 and 60 characters. Changing this name only affects how the project appears to you.

Rename Project card with shop-prod entered in the project name field and the pointer on Rename

  1. Click Rename. While saving, the button reads Saving.... When finished, ODAC displays a green Project renamed successfully banner above the field and immediately updates the project name in the top-left header selector. If the field is empty, under 2 characters, or over 60 characters, a red banner appears above the field instead (Project name is required, Name must be at least 2 characters, or Name can't exceed 60 characters).

Top header and Rename Project card showing the Project renamed successfully banner and shop-prod updated in the header

Set the default deploy server

  1. In the Servers card on the right, review the servers attached to your project. Each row shows a radio indicator on the left, the server name, its operating system, architecture, and IP address beneath it, and a green Default badge on the right of the active default server. New apps you add to the project deploy to this Default server. If no servers are attached yet, ODAC displays No servers are assigned to this project yet. instead.

  2. Click any attached server row that does not have the Default badge to make it the new default deploy target for new apps (clicking the server already marked Default does nothing).

Servers card with prod-eu-1 marked Default and the pointer clicking staging-us-1

  1. ODAC refreshes the page with the filled green indicator and Default badge moved to the server you clicked.

Servers card after updating, showing staging-us-1 with the filled green indicator and Default badge

  1. If the project already has apps running on its current server, ODAC prevents changing the default and shows This project has apps running on its current server. Move or delete them before changing the default. above the server list. Move or delete those apps first (see App activity history and moving between projects and Inspect, rename, restart, and delete an app), then switch the default server.

Servers card showing the red error banner when attempting to switch the default server while apps are running on the current server

Assign another server

  1. Under Assign a server in the Servers card, click Select a server… to open the list of other servers linked to your account that are not yet attached to this project. Type in Search servers… to filter the list by name (if nothing matches, it reads No servers match your search.), then click a server to select it. If the server you need is not linked to your account yet, click Add a new server at the bottom of the dropdown to open Servers and connect it first (see Connect a server).

Servers card with the Assign a server dropdown open, showing Search servers, edge-fra-1 hovered, db-eu-2, and Add a new server

  1. With the selected server name displayed in the selector, click Assign. While assigning, the button reads Assigning.... If you click Assign without choosing a server first, Choose a server to assign. appears above the selector.

Assign a server selector showing edge-fra-1 chosen and the pointer on Assign

  1. The page refreshes with the newly assigned server added to the Servers list above. If the project had no servers attached before, the first server you assign automatically becomes the Default deploy target and begins deploying any queued apps (see Queueing apps before connecting a server). Once every server in your account is assigned to the project, the selector is replaced by All of your servers are assigned to this project. and an Add a new server button (or Link a server first if your account has no linked servers yet).

Servers card after assigning edge-fra-1, showing all three servers in the list and All of your servers are assigned to this project below