Set up Rostoc

The first time you open Rostoc you sign in, fill in your business, and — if Artisan or Cropster is on the computer — choose what to bring in from it. Then you are in the app. Everything else is a checklist you work through at your own pace, in whatever order suits you.

The setup screens

Create your account. Rostoc opens your browser to sign up or log in, then returns to the app.

Your business. Your business name, website, country, units, currency and the app’s look (light or dark). Rostoc fills in what it can: from your Artisan or Cropster setup when it finds one on this computer, otherwise from where the computer is — its time zone and region — and the email you signed up with. A computer in the United States starts on Fahrenheit and pounds, most others on Celsius and kilograms. Change anything that’s off, then click Continue.

Units are display preferences — you can change them later in Settings → Preferences, and changing them converts what you see rather than rewriting anything.

If Rostoc found Artisan or Cropster, the next screens bring your setup in — see Bring in your Artisan or Cropster setup below. If it found neither, setup ends on the Add a Machine dialog, so you can pick your roaster from the catalog.

On some computers setup shows a single Pick your units screen instead of Your business. The units on it start pre-filled the same way; click Get started to go on.

Otherwise setup opens on Home.

Bring in your Artisan or Cropster setup

When Rostoc finds Artisan or Cropster on the computer, it reads your machines, green coffee, profiles and past roasts, and asks before bringing anything in. Reading never changes anything on your computer. A large setup can take a minute; the screen reads Reading your setup on this computer meanwhile.

Each step lists what Rostoc found, with a preview of how it will look in the app beside it. Uncheck anything you don’t want. A step with nothing found is left out.

Your machine. Every machine found in your Artisan or Cropster setup, each with a checkbox. Rostoc tries them as the step opens, reading only. A machine that answers shows Connected with the temperature it is reading, and moves to the top. One that does not answer yet says what it is waiting for:
- Artisan is open. Close it and Rostoc connects. (or Cropster) — quit the other app and the machine connects within a few seconds.
- Plug it in and switch it on. — a USB or serial machine.
- Switch it on, with this computer on its network. — a network machine.
Continue adds the checked machines, whether or not they have connected yet. A machine that did not connect is tried again the next few times you open Rostoc, and you see Your … is connected when it answers.
Your green coffee. Each coffee with its Lots, at the weight Cropster last saved — check the stock once it is in. A coffee whose origin Rostoc could not find asks for its country. Click Bring them in, or Not now to skip it.
Your plans. Two lists. The plans: the Cropster profiles you used in the last 12 months, each with its reference roast as the Reference Curve. Profiles you haven’t used since then sit behind one Bring in all … profiles row, unchecked. The roasts: your other past roasts, which come in as Batches. Click Bring them in, or Not now to skip it.

From Artisan, the roasts you used as a reference become Plans and your other Artisan roasts come in as past Batches. Artisan keeps no green coffee, so there is no green coffee step. When both programs are on the computer, green coffee, Plans and Batches come from the one you roasted with last, and the step titles name it.

The last step stays open while your data comes in, with a count — for example 27 plans, 28 roasts and 18 coffees are in. You don’t wait for everything: when you have many profiles, the first ones come in before setup ends and the rest follow in the background. The Plans page shows Bringing in plans from Cropster: 120 of 482 meanwhile, and Home shows Your roasts are still coming in while your roast files are read.

The roasts setup brings in never count toward your free trial or your monthly roasts, and they never take stock off your Lots.

Bring in more later

Open Settings → Account and click Import from Artisan or Cropster, under Roasting software. Rostoc reads this computer again and offers only what is not in your account yet, so nothing comes in twice. When Rostoc finds a new machine or program on a computer, Home also shows a short notice — for example New on this computer: a machine from Artisan. — with Take a look.

Something you unchecked, or deleted after it came in, is not offered again. If something you wanted did not come in, ask the assistant or write to us — the team can bring in the rest.

On the Hobby plan

Setup brings in every machine and your green coffee on any plan. The plan then decides what you can use: on Hobby, one machine is usable — the one that connected during setup, otherwise the newest — and the others show Not Available on Machines, and your green coffee waits behind Inventory Requires Growth. Roasts on Hobby take nothing off your Lots. Upgrade to Growth and your coffees and Lots show at the weights they came in with.

The Get started checklist

Home shows Get started in its left column until you have worked through it, with a counter beside the heading.

Row	What it does	Counted
Connect your machine	Opens Machines, where you pick your roaster from the catalog and link it. See Add your first machine.	Yes
Add a green	Opens Coffee lines with the new-coffee form open, so stock tracks itself from your first roast.	Yes
Create a roast plan	Opens Plans with the create form open, for your charge weight, weight loss and a Reference Curve. Start from an Artisan or Cropster roast, under the row, asks for a roast file instead and opens the form on its curve. See Plans.	Yes
Roast your first batch	Opens Plans, so you can start Roast Studio from the Plan you made. Only a roast recorded in Rostoc ticks it; an imported roast does not.	Yes
Remove demo data	Deletes the demo coffees, Lots, Batches, Plans, and orders that came with the account. Anything you created or imported stays, and so does anything demo you made your own — see The demo data.	While there is demo data to remove
Tell us what’s missing	Opens the feedback form.	No — it is optional

Each row checks itself off from what is actually in your account, not from whether you clicked it — so a machine or Plan that setup brought in counts the same as one you made by hand. Rows completed on one computer show as completed on another.

Once the checklist is done, the column becomes Needs Attention and starts showing your real work.

Starting Rostoc

Opening Rostoc a second time brings up the window that is already open. You never get a second copy of the app.

On Windows, if you click a sign-in link in your browser while Rostoc is still starting, the link is not picked up. Wait for the Rostoc window to appear, then sign in again.

The demo data

A new account can arrive with demo coffees, Lots, Batches, Plans, and an order in flight, so Home, Coffee lines, and Batches have something to show while you find your way around.

Setup decides for you whether you need them:

Something came in from Artisan or Cropster — green coffee, Plans or roasts: the demo data is removed when setup ends, and Home opens on your own data.
Nothing came in — nothing was found, or you chose Not now on every step: the demo data stays.

To remove it yourself, use the Remove demo data row on the checklist, or Remove demo data on the demo notice at the top of Home. Rostoc asks to confirm, then deletes only what it created. This cannot be undone.

Removal keeps what you made your own:

A demo Plan you renamed, edited or roasted with stays, with your changes, its roasts and its coffee. It loses the demo reference roast: set a Reference Curve from one of its roasts.
A demo Lot you roasted from, adjusted, or received stock into stays, with its coffee.
A demo coffee that one of your roasts or kept Plans names stays; its unused demo Lots go.

Once you remove the demo data, it never comes back.

After your first roast

If you did not fill in Your business during setup, Rostoc asks once, after you record your first Batch, where you roast — your country, your team size, and your roastery name if you want to give it. It shapes what gets built next. Skip it and it does not come back.