Quick Start
This guide walks you through deploying your first workflow on Datatailr in under 5 minutes.
Prerequisites
- Access to a Datatailr instance (ask your administrator for the URL)
- A user account (your administrator will provide your credentials)
Running locally?
You can run Datatailr on your own machine to try it out before deploying to the cloud. In that case, open https://localhost.datatailr.com and log in with username admin and password admin.
First login: the guided tour
The first time you log in to the web interface, Datatailr opens a short guided tour. Users who can open Compute Processes or Workstations first choose what they plan to build, connect a coding agent, and copy a first prompt. Then the tour goes through the pages you can use. Other users see a welcome page and the page tour.
The tour opens once, when you arrive at the home page after your first browser login. Skip it at any time with Skip the tour. Logging in from the command line or the SDK with datatailr login (with or without --device) does not count as a first login.
To open the tour again, click the help menu in the sidebar and select Take the tour.
An administrator can turn the tour off in Settings → General → System with the Onboarding tour switch. When it is off, the tour does not open and Take the tour is hidden from the help menu.
Step 1: Open a Workstation
A workstation is your development environment in Datatailr — a container with an IDE, Python, and the Datatailr SDK pre-installed.
- Log in to the Datatailr dashboard.
- Click the Workstations
icon in the left sidebar.
- Click VS Code or Jupyter to launch your workstation.
Your workstation will start and open in a new browser tab.
Step 2: Initialize a Demo Project
Open the terminal inside your workstation and run:
datatailr init-demo
This creates a demo project with example workflows, apps, and services, and opens it in a new IDE window.
Step 3: Deploy a Workflow
From the demo project directory, deploy the data pipeline example:
python -m deploy workflow
This builds a container image with your code, uploads it to Datatailr, and schedules it for execution.
Step 4: Check the Results
Go back to the Datatailr dashboard — your workflow will appear in the list of compute processes. You can:
- Watch its status change from Building → Ready → Running → Completed
- Click on it to view logs and output
You can also check the status from the terminal:
dt job ls
What Just Happened?
When you deployed the workflow, Datatailr:
- Packaged your code and dependencies into a Docker container image
- Stored the image in its internal registry
- Scheduled the workflow for execution
- Allocated compute resources and ran the workflow
- Collected logs and results
To learn more about how this works, continue to Compute Processes.
Try More Examples
The demo project includes several other examples you can deploy:
python -m deploy service # A FastAPI REST API
python -m deploy app # A Streamlit dashboard
python -m deploy excel # An Excel add-in
python -m deploy all # Deploy everything
The Streamlit dashboard gets its data from the FastAPI service, so deploy the service before the app.
Next Steps
- Workstation — Learn how to create and configure workstations
- Compute Processes — Understand workflows, apps, and services
- Compute Process Lifecycle — Learn about process states and lifecycle
- Python SDK — Full SDK reference