Back to guides
Beginner10 min

Getting started with Marathoon

Create your account, set up your first project, and run your first pipeline.

What you'll build

By the end of this guide you'll have a project, a published pipeline, and a completed job with results.

1. Create an account

Sign up from the sign-up page. Your organization becomes a tenant — an isolated workspace with its own projects, members, credit balance and settings.

2. Create a project

A project is the top-level container for pipelines. From the dashboard, go to Projects → New Project. Projects control access: members are granted access per project with the roles Owner, Maintainer, Analyst or Viewer.

3. Define a pipeline

A pipeline wraps a Docker image with declared inputs, outputs and resources. Use the visual editor, import a JSON definition, or start from an example in Pipelines → View examples.

A minimal definition:

{
  "name": "My first pipeline",
  "definition": {
    "imageUri": "hello-world",
    "imageTag": "latest"
  },
  "defaultParameters": { "cpuUnits": 1, "memoryMb": 512, "timeoutSeconds": 600 }
}

4. Publish it

A pipeline must be published before jobs can run against it. Each change is saved as a new version that you can compare or revert to; a job runs the definition in force when it starts.

5. Run a job

Click Run on the pipeline page, provide any inputs, and submit. Watch the status move Queued → Running → Succeeded live. Every job shows structured logs, container output, downloadable artifacts, and a visual report when the pipeline produces one.

Next steps