Home > docs > getting started > Quickstart
If you have installed your own Concord server or have access to a server already, you can set up your first simple Concord process execution with a few simple steps:
Concord process definitions and their resources are best managed and source controlled in a Git repository. Concord can automatically retrieve the contents of the repository and create necessary resources and executions as defined in the content.
Start with the following steps:
As a next step, add the Concord file concord.yml
in the root of the repository.
A minimal example file uses the automatically used default
flow:
flows:
default:
- log: "Hello Concord User"
The default
flow in the example simply outputs a message to the process log.
In order to grant Concord access to the Git repository via SSH, you need to create a new key on the Concord server.
mykey
as Name and select Generate a new key pair as Type;The user interface shows the public key of the generated key similar to
ssh-rsa ABCXYZ... concord-server
. This value has to be added as an authorized deploy
key for the git repository. In GitHub, for example, this can be done in the
Settings - Deploy keys section of the repository.
Alternatively the key can be created and accessed with the REST API for secrets.
Now you can create a new project in the Concord Console.
mykey
;git@github.com:me/myrepo.git
;If global authentication/trust between your GitHub repositories and the Concord server is configured, you can simply use the HTTPS URL for the repository in the URL field.
Alternatively you can create a project with the REST API.
Note: project creation in the Default organization might be disabled by the instance admins using policies
Everything is ready to kick off an execution of the flow - a process:
A successful process execution results a message such as:
{
"instanceId": "e3fd96f9-580f-4b9b-b846-cc8fdd310cf6",
"ok": true
}
The Open process status button navigates you to the process execution and
provides access to the log, forms and more. Note how the log message
Hello Concord User
is visible.
Alternatively the process can be accessed via the queue:
Alternatively the process can be started via the Process REST API.
Congratulations, your first process flow execution completed successfully!
You can now learn more about flows and perform tasks such as
and much more. Have a look at all the documentation about the Concord DSL, forms, scripting and other aspects to find out more!