Create a service
Use Applications → Environment → Add service (or the new-Application wizard) to create Services; then configure and deploy.
Written By Zoro
Last updated 3 days ago
Create Services inside an Environment
Create Services inside an Environment so they run on that Environment’s compute. You can add Services while finishing a new Application or anytime afterward.
Prerequisites
- An Application with at least one Environment that has compute attached. See Create an application under Applications in the sidebar, Create an environment under Environments in the sidebar, and Attach compute to an environment under Environments in the sidebar.
- For App Services from private Git: a connected provider. See Integrations overview under Integrations in the sidebar and Connect your Git provider under dFlow Cloud in the sidebar (dFlow Cloud).
- For Docker Services from a private registry: a configured registry account. See Docker registry integration under Integrations in the sidebar.
Conceptual background: Services (concept) under Core Concepts in the sidebar and How services relate to environments.
Path A: New Application wizard
When you use Create New Application, the wizard includes a Services step (Application → Environment → Compute → Services). Complete that step to activate the Application (see Application lifecycle under Applications in the sidebar). Use Add New (or equivalent) on the canvas to pick App, Database, or Docker, configure each Service, then deploy from the UI when you are ready.
Services created here are already bound to the Environment you set in the wizard.
Path B: Existing Application and Environment
- Open Applications and select your Application.
- Open the target Environment (for example from Environments → row, or your default environment shortcut).
- Use Add New → Add service (or Create Service, depending on layout) and choose App, Database, or Docker.
- Enter a Service name and complete the type-specific fields (repository, image, database engine, and so on).
- Confirm Create Service (or Save). dFlow opens or returns you to the Service detail view.
- Finish configuration on the Service tabs (source, variables, domains, and so on), then Deploy or Redeploy so changes take effect on the server.
For databases specifically, follow Databases overview under Databases in the sidebar or Create a database service under Databases in the sidebar for the same flow with credential and Expose details.
After creation
- App: set Git (or other) source, branch, and build settings; add Service settings variables; deploy when ready.
- Database: Databases overview under Databases in the sidebar. Deploy provisions the engine; use Overview for credentials and database credentials and connections under Databases in the sidebar for app wiring.
- Docker: set image, ports, and resources; use Variables and volumes as needed; deploy.
Ordering and dependencies
You can add multiple Services in one Environment. If one Service references another (for example an App referencing a database URL), create the database Service first, deploy it successfully, then add reference variables on the App. See Service settings.
If deploy fails
- Open Deployments and Logs on the Service. See Logs under Deployments and Operations in the sidebar.
- Use Deployment issues under Troubleshooting in the sidebar for common failure patterns.
- For databases, see Database troubleshooting under Databases in the sidebar.