Finding your way around
The dashboard, a project's page and diagram, quick search, notifications and User settings.
A map of the dashboard at app.appentic.com.
The sidebar
The sidebar is on the left of every page. On a narrow screen, open it with the menu button in the top bar.
- Workspace switcher, at the top. Switch workspaces, create one, or open the workspace's Settings if you own it. See Workspaces and collaborators.
- Search, which opens quick search.
- Projects, the projects in the current workspace. Inside a project, this part of the sidebar shows the project's own pages instead.
- User menu, at the bottom, with your name. It has User settings and Log out.
The dashboard
The Dashboard shows a card for each project in the workspace, with how many services it has, its health, and when it was last deployed. Click a card to open the project, or click New Project to create one.
A project's pages
A project's sidebar has:
| Page | What it's for |
|---|---|
| Services | Every service in the project, and the project's diagram. |
| Athena | Build or change the app with Athena, or ask it to troubleshoot. |
| Environment | Environment variables for the project's services. |
| Networking | The project's private network: private access, connected networks, the outbound address and traffic rules. |
| Resources | The project's machines: add, change, stop and remove them, and see how their memory is shared. |
| Settings | Rename the project or delete it. |
Dashboard, at the top of the sidebar, takes you back to all your projects.
The Services page
The Services page lists the project's resources in sections: Web Services, Databases, Key Value Stores, Storage, Volumes, Firewall, Load balancers, Cron Jobs and Background Workers. Click Add in a section's header to create one.
Each row reads the same way:
- the resource's name
- its status, as a coloured dot and a word, for example ● Live. Green means it is running, amber means it is changing (such as deploying or starting) or in maintenance, and red means it has failed or is stopped.
- when its status last changed, for example · 37m ago
- on the right, its size (memory, or a volume's GB) and the machine it runs on
The lists update on their own. You don't need to refresh the page to see a deploy finish.
If a project or one of its machines is stopped or suspended, a notice at the top of the page says so, with a link to fix it.
The project diagram
Under the lists, the diagram shows how the project fits together:
- Internet at the top, then any firewall and load balancers that traffic passes through.
- Each machine as a box, with its status, CPU and memory use, and public address.
- The services on each machine, in rows: the firewall, then web services, then workers and cron jobs, then databases and key value stores. Web services, workers, databases and key value stores show their own CPU and memory use.
- Storage to the right of the machine its services run on, level with the services.
- Volumes below the machines, each under its database.
- A standby appears on its own machine, labelled (standby).
The lines show what connects to what, such as a web service to the database it uses. A green line is working and a red one is broken. A dashed line crosses between locations.
A dotted line hangs a worker or cron job off its web service. The worker or cron job runs that web service's code with its connections, so the web service's lines to the database, store and storage are drawn once, from the web service. A dotted line also joins a database or key value store to its standby.
When a service uses idle memory beyond its guarantee, its memory bar shows its real use in amber, for example 768 MB, over its 512 MB.
The diagram updates as things change, and its usage bars refresh every 30 seconds.
Details cards
Click the ⓘ on any card in the diagram to see its details: its status, size, what it's using now and everything it connects to, and for a machine its location, spec, public address and monthly price. Press Esc to close it.
Quick search
Press ⌘K on a Mac or Ctrl+K on Windows and Linux, or click Search in the sidebar. Type to jump to any project, service or one of its tabs (for example api · Logs), machine, domain, environment variable name or settings page, or to start something new, such as New web service.
Search understands related words: "redis" finds key value stores and "agent" finds Athena.
Use ↑ and ↓ to move, Enter to open and Esc to close.
Notifications
The bell in the top bar shows a count of unread notifications. Click it to see recent ones, such as finished deploys or a resource that failed. Click a notification to mark it read, or click Mark all read.
Choose what appears there in User settings → Notifications. See Notifications.
The ? button next to the bell opens these docs.
User settings
Open the user menu at the bottom of the sidebar and choose User settings. Its pages are:
| Page | What it's for |
|---|---|
| Account profile | Your display name, email and account ID. See Profile and sign-in. |
| Connected accounts | How you sign in, the GitHub App, code fixes and coding agents. See GitHub. |
| Notifications | What appears under the bell. See Notifications. |
| Support | Contact us and see your tickets. See Support. |
| Billing | Your balance, low-balance alerts, transactions and usage. See How billing works. |