Start here
This page defines the words the rest of the guide uses, and walks through your first tasks in Radd.
Radd is a self-hosted issue tracker and wiki. One server holds every project's work items and every space's pages. A team tracks its work and documents it in the same place.
The rest of this guide uses these words for one meaning each.
- Server — the Radd installation. One server holds every project and every wiki space.
- Project — a container for work items. Each project has a short key, for example RADD. A key is unique across the server.
-
Work item — the general term for an epic, an issue, or a subtask.
- Epic — a work item that groups issues.
- Issue — a work item inside an epic. Most work happens at this level.
- Subtask — a work item inside an issue, for one step of the work.
- Type — a work item's classification, for example Bug or Task. A project defines its own types.
- State — a work item's position in its project's workflow, for example Todo or In Progress.
- Category — the group a state belongs to: triage, backlog, todo, in progress, done, or canceled. Every state belongs to one category. An administrator can rename a category. Its behavior does not change.
- Workflow — the states a project uses, and the moves it allows between them.
- Field — one piece of data on a work item, for example Priority, or a custom field a project added.
- Label — a free-text tag on a work item. One label list serves every project on the server.
- View — a saved query with a display. The display is a board, a list, a planning view, a queue, or a roadmap.
- Cycle — a time box for planning work, for example two weeks.
- Release — a version of a project's work. A release can hold work items and record when the work shipped.
Open the Radd address for your server. Radd shows the sign-in page.
Type your email and your password, then click Sign in. If your account has two-factor authentication turned on, Radd asks for a code from your authenticator app.
An administrator can turn on other ways to sign in:
- Directory — sign in with your directory username and password. A Directory tab appears next to Email only when an administrator turns this on.
- Single sign-on — click a button below the sign-in form, for example Sign in with Google. A button appears for each single sign-on provider an administrator adds.
An administrator decides which of these ways your server offers.
- Open Radd. It opens on My Work, the page that lists work assigned to
you, work due soon, and work you starred.
- Click a work item's key or title. The item opens in a panel on the right, over the page you were on.
- Find State in the panel. Select a new value. Radd only lists the states allowed next in your project's workflow.
- Type a note in the comment box, under the Comments tab, then click Comment.
- If the project logs time, click Log work. Type the time you spent, then click Log work again to save it.
Read The application window next. It names every part of the screen. Then the other pages can say "the sidebar" or "the pins bar", and you already know where to look.
Then read about the parts of Radd you will use first:
| Page | Covers |
|---|---|
| Work items | Epics, issues, subtasks, and the item page |
| Views | Boards, lists, and the other saved-query displays |
| Search and the query language | Finding work, and the SLQ query language |
| Time logging and the timesheet | Estimates, worklogs, and the timesheet |
| Personal settings | Your profile, appearance, tokens, and sign-in security |
For every setting on the server, see Project settings and Instance settings.
Mirrored from project.radd-hq.com on 2026-09-12. Documentation is written there; this copy is regenerated by scripts/publish_wiki.py and hand edits do not survive it.