Rostoc Setup Help
Short guides for the setup questions Rostoc support sees most often. These pages are generated from the same reviewed mini-guides used by the support agent.
Capability Checks
Capability ChecksConnected But No ReadingsA successful connection does not always mean temperature data appears immediately. Some machines only send readings once the machine is ready or a roast has started.Capability ChecksFirst Roast ValidationAfter connecting a machine for the first time, run a short test roast before relying on the setup for a real roast. Check that the temperatures and labels match the machine display.Capability ChecksMachine Control Versus LoggingMachine control means controls in the Rostoc desktop app that send burner, airflow, drum-speed, setpoint, or machine-specific commands. It is available by default for every account, gated by the exact machine model and connection. A machine can support live data logging without supporting direct control. Connecting a machine only reads from it: Rostoc changes nothing on it until the roaster sends a setting from Roast Studio. From Rostoc 0.4.9 the one exception is a machine that needs a command as each roast starts and ends, such as the HB PEAK, whose roast mode Rostoc switches on when a recording starts and off when it is stopped or aborted.
Computer Setup
Computer SetupAllow A USB Roaster On macOSOn a Mac laptop with Apple silicon (macOS 13 Ventura or later), macOS asks you to approve a new USB accessory before any app can use it. Until it is allowed, the roaster can be plugged in and switched on while Rostoc still cannot talk to it. Approving it takes a moment: with the Mac unlocked, unplug the roaster's USB cable, plug it back in, and choose Allow when macOS asks. For an Aillio Bullet, Rostoc says this itself. From Rostoc 0.4.8 its waiting banner reads "Your Mac has not allowed your … yet. Unplug it, plug it back in, and choose Allow when your Mac asks.", and Rostoc connects by itself once it is allowed. A failed connection can also say "macOS can see the Aillio Bullet but has not allowed apps to use it."Computer SetupBringing In An Artisan Or Cropster SetupWhen you first sign in on a computer that has Artisan or Cropster, Rostoc finds your setup there and asks before bringing anything in. Setup has up to four steps: Your business, Your machine, Your green coffee and Your plans. A step with nothing found is left out. Each step lists what was found, with a preview of how it will look in Rostoc beside it, and you uncheck anything you don't want, or choose Not now to skip the green coffee or plans step. Reading your setup never changes anything on your computer, and while Rostoc tries your machines it only reads from them. Rostoc brings in your machines, your green coffee (each coffee with its lots), your profiles as plans with their reference roasts, and your past roasts as batches. 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 that step is not shown. When both programs are on the computer, green coffee, plans and batches come from the one you roasted with last. Cropster profiles you used in the last 12 months are listed; the others come in only if you check Bring in all … profiles. You don't wait for everything. The profiles you roast now come in first, and the rest, with your roast files, follow in the background while you start working; Home and the Plans page show how far it has got. The roasts setup brings in never count toward your trial or your monthly roasts, and never take stock off your lots. If you had demo data and something came in, the demo data is removed for you; if nothing came in, it stays. You can run it again any time from Settings → Account → Import from Artisan or Cropster. It offers only what is not in your account yet, so nothing comes in twice. If something you expected did not come in, the team can bring in the rest.Computer SetupCheck Or Change Computer IP On macOSOn macOS, the computer IP is changed in Network settings. Use this only when a direct Ethernet setup needs the computer to be on the same local network range as the machine. If this computer is on a managed company network, ask your network admin or Rostoc support before changing adapter settings.Computer SetupCheck Or Change Computer IP On WindowsOn Windows, the computer IP is changed from the network adapter IP settings. Only change it when a direct Ethernet setup needs the computer to be in the same network range as the machine. If this computer is on a managed company network, ask your network admin or Rostoc support before changing adapter settings.Computer SetupCheck USB Cable And DriverUSB connection failures are often caused by a charge-only cable, a bad USB port, the machine not being ready, or a missing driver. A USB cable can charge a machine and still not carry data.Computer SetupClose Other Roasting SoftwareMany USB, serial, Bluetooth, and device-driver connections can be used by only one app at a time. If another roasting app is already connected, Rostoc may not be able to read the machine. Rostoc then says Port Busy, on Windows and on a Mac. On a Mac, a program that uses the port without locking it can still let it open, and the machine then reads as Device Not Responding: close other roasting software in that case too. For an Aillio Bullet, Rostoc names the app when it can — for example RoastTime Is Open — and waits: it connects by itself once the app is closed.Computer SetupDirect Cable Or Local NetworkFor Ethernet machines, Rostoc usually connects in one of two ways: through the same local network/router as your computer, or with a direct Ethernet cable from the machine to the computer. The router path is usually easier; the direct cable path often needs manual IP settings on the computer.Computer SetupFind COM Ports On WindowsFor USB serial machines and USB-to-RS-485 adapters on Windows, the connection usually appears as a COM port. If Rostoc cannot find it, check Device Manager for the port and any driver warning.Computer SetupFind Serial Devices On macOSOn macOS, USB serial devices are usually checked through System Information and then selected in Rostoc. Macs do not use Windows COM port names.Computer SetupFind Your Machine Connection Settings In CropsterCropster's Roasting Intelligence keeps the machine connection under Preferences → Machine, and there is no export for it. On the computer where Roasting Intelligence runs, Rostoc's setup lists your Cropster machines for you, and for a Modbus serial connector it also finds the port. For anything else, the values are read off the screen. The good news is that there are usually only two or three you need: the connector type, and the machine's IP address or serial port. Rostoc's catalogue fills in the rest, so most people only carry across the address.Computer SetupFind Your Machine Connection Settings In RostocEvery setting Rostoc uses to reach your roaster is on one screen. Open Machines from the sidebar (or press G then M) and click Configure on the machine. Its settings open on Connection. The left side holds the connection itself — the address or port and its parameters — and the right side, Stream Configuration, holds each reading Rostoc expects and how it is read. You can read these values off the screen at any time, and a screenshot of that one screen is the fastest way to show support exactly how the machine is set up. A machine's USB serial port and its Bluetooth device are kept on each computer: the roastery PC and a laptop can each use their own port for the same machine without changing the other's. Everything else on the screen is the same on every computer.Computer SetupGet Your Machine Setup Out Of ArtisanIf your roaster already connects in Artisan, you do not have to copy the settings across by hand. On the computer where Artisan runs, Rostoc's setup finds your Artisan machines itself and adds the ones you check; later, Settings → Account → Import from Artisan or Cropster does the same. Otherwise: Artisan keeps its whole configuration in one settings file, and Rostoc reads that file directly: save an .aset file from Artisan, then add the machine in Rostoc with Import from Artisan. If you would rather read the values yourself — to check them against a machine manual, or because the import needs a second look — they live under Config » Port and Config » Device.Computer SetupKeyboard ShortcutsKeyboard shortcuts are available in the Rostoc desktop app, not at web.rostoc.co. Press ? or Command/Ctrl + / outside an editable field to see the shortcuts for the current window. Single-letter shortcuts can be disabled in Settings → Preferences without disabling Command/Ctrl shortcuts.Computer SetupRemoving Demo DataDemo coffee lines, lots and roasts can be removed by the account holder, without contacting support. A notice on Home offers Remove demo data, and the same action is available from the Get started checklist. Removal deletes only the demo content Rostoc added; anything you created or imported is left alone. Anything demo you made your own stays too: a demo plan you renamed, edited or roasted with, a demo lot you roasted from, adjusted or received stock into, and a demo coffee that one of your roasts or kept plans names. A kept demo plan keeps your edits, its roasts and its coffee, but it no longer points at the demo reference roast, so it opens with "No reference curve set for this plan." until you set your own. Once removed, demo data never comes back. When you set up Rostoc on a computer with Artisan or Cropster, you usually don't need to remove it yourself: if setup brings in anything (green coffee, plans or roasts), the demo data is removed when setup ends. If nothing came in, it stays.Computer SetupRostoc Web Appweb.rostoc.co provides browser access to Rostoc data for Foundation, Growth, and Scale accounts. Hobby users can sign in but see the browser-access paywall. The web app requires an internet connection. Machine connection, Machine controls, Roast Studio, and recording remain desktop-only.Computer SetupTemperature, Weight And Currency UnitsRostoc displays temperature in Celsius or Fahrenheit, and the choice is yours, in Settings → Preferences. Weight unit and currency are set in the same place. When you first set up Rostoc, the units start pre-filled: from your Artisan or Cropster setup when Rostoc finds one on the computer, otherwise from where the computer is — a computer in the United States starts on Fahrenheit and pounds, most others on Celsius and kilograms. You can change them right there, or any time later. The display unit is separate from what the machine itself reports, so a machine configured in one unit can be read in the other. From Rostoc 0.4.6, roast charts follow the unit from the first launch: in Fahrenheit the temperature axis ticks every 20 °F and the Rate of Rise scale starts at -10 to 55 °F per minute.
Connection Diagnostics
Connection DiagnosticsConnection StatusWhen readings stop, Rostoc says why: not responding (the machine stopped answering; Rostoc keeps trying), then connection lost — reconnecting, then could not reconnect if every attempt fails. A machine switched off after roasting goes through the same steps. That is expected. An Aillio Bullet is the exception: Rostoc never gives up on it. It shows "Your … is off or unplugged. Rostoc reconnects when it is back." and connects again when the Bullet comes back. What each one means: - Readings greyed out: no new reading has arrived. The last values stay on screen. - Not responding: the connection is still open, but the machine stopped answering. Rostoc keeps reading, and the readings come back by themselves as soon as it answers. - Connection lost — reconnecting: the machine stayed silent, or its USB port disappeared, so Rostoc closed the connection and is reconnecting by itself, up to 6 attempts. - Could not reconnect — connect manually from Machines: every attempt failed. Rostoc stops trying until you press Retry or connect the Machine again.Connection DiagnosticsFind The Machine IPFor Ethernet or Wi-Fi machines, Rostoc needs the machine IP address. You can usually find it on the machine display, controller screen, machine manual, prior setup notes, or the router device list.Connection DiagnosticsMachine IP Versus Computer IPIn Rostoc, enter the machine IP address. The computer IP is only used to make sure your computer is on the same local network range as the machine. An address of 127.0.0.1, localhost, or an empty address field points at the computer running Rostoc, not the roaster.Connection DiagnosticsNucleus Link Guided Connection TestTest Connection opens a separate guided window that walks through connecting to Nucleus Link step by step: opening the USB connection, then waiting for a started roast so it can confirm live bean temperature and fan data. Rostoc advances each step automatically as it detects them; nothing needs to be clicked to move between steps.Connection DiagnosticsRouter Changed The Machine IPIf the machine is connected through a router, the router may assign a new IP address after restart or reconnect. If Rostoc worked before and now cannot connect, recheck the machine IP.Connection DiagnosticsRS-485 Wiring And Adapter CheckRS-485 machines usually connect through a USB-to-RS-485 adapter. If Rostoc sees the adapter but the machine does not respond, check that the adapter wires match the labels in the machine manual. Do not change advanced settings unless support asks.Connection DiagnosticsStatic IP For Direct Ethernet CableWith a direct Ethernet cable, the computer needs an address that looks like the machine address, but is not identical. The safest default is to keep the machine settings as they are and adjust the computer Ethernet adapter to match that range or, if the machine allows, change the machine IP to a fixed IP where the last number is different from that one of the computer and it's not 1.
Machine Setup
Machine SetupChoose The Kaleido Connection PathKaleido support depends on the exact model, edition, and connection path. Rostoc has catalog paths for network, serial, and legacy Kaleido setups.Machine SetupFind The IP On A ProbatFor Probat Ethernet setups, Rostoc needs the roaster IP. On many Probat P Series machines, check Preferences -> General. On some Probatone Series II machines, use the network or radio icon. If neither applies, the machine display, your existing setup, or Probat documentation are the reliable sources.Machine SetupGiesen S7 SetupRostoc supports selected Giesen machines through an experimental Ethernet connection path. If you are only asking whether Giesen is supported, answer that first. If you are actively trying to connect, the exact model, production year, IP setup, and unlock-code status can help support review the setup quickly.Machine SetupKaffelogic Nano 7 USB And First ReadingsKaffelogic Nano 7 connects to Rostoc over supported USB serial setups. If the connection test succeeds, temperature data may not appear until the roast starts.Machine SetupNucleus Link USB And First ReadingsNucleus Link connects to Rostoc over USB for live sample roast logging. If the connection test succeeds, temperature data may not appear until the roast starts.Machine SetupPhidget USB Has No COM PortPhidget USB setups do not use a COM port in Rostoc. Rostoc talks to the Phidget USB device directly, so check the Phidgets driver or control panel instead.Machine SetupProbat Network TroubleshootingMost supported Probat Ethernet setups need the roaster and computer on the same local network, or a direct Ethernet setup with matching IP ranges. Rostoc needs the roaster IP address.Machine SetupRostoc Is Waiting For The Aillio BulletWhen Rostoc cannot reach your Aillio Bullet yet, it does not fail: it waits. A banner reads "Waiting for your …" with your machine's name, the machine's card on Machines says the same, and Rostoc connects by itself the moment the Bullet is ready. You do not need to click Connect again. The line under the title says what is in the way: the Bullet is not switched on or plugged in, your Mac has not allowed it yet, another app such as RoastTime is using it, or the Bullet plugged in is a different generation from the machine you chose. Fix that one thing and Rostoc connects, then shows "Your … is connected" with Open Roast Studio.
Setup Help
Setup HelpChanging Or Removing A Control Value On The ChartFrom Rostoc 0.4.8, a gas, airflow or drum value you typed can be changed or removed on the chart, during the roast or after the batch is saved. Hover the control's line in the lower chart, click the handle on the value, and choose Change value or Remove. The saved batch keeps the correction. Only values you typed can be changed: a value the machine reported, or a change Rostoc sent to the machine, stays as recorded.Setup HelpChoosing What The Charts And Readouts ShowFrom Rostoc 0.4.9 each Machine decides which of its probes and readings each chart draws. In the Machine's Style & Colors settings every channel has Show in with two boxes: Roast Studio and Batch chart. Roast Studio draws the ones ticked for it; a saved roast's chart and a comparison draw the ones ticked for Batch chart. BT is always shown. Readouts, in the chart's ⋯ menu in Roast Studio, chooses up to four large values in the sidebar, BT and ET by default.Setup HelpComparing Roasts With Batch CompareBatch compare puts two to ten roasts side by side. Their curves are laid over each other on one chart, lined up on a milestone the roaster chooses, and a Metrics table compares each roast's numbers against a reference roast. From Rostoc 0.4.9 it is open to every account on every plan, in the desktop app (in its own window) and at web.rostoc.co (as a page).Setup HelpEditing And Deleting Roast PlansA plan holds the setup you reuse for a roast: name, charge weight, target weight loss, Machine, green coffee, a reference curve and notes. Open the plan and use Edit Plan to change the name, charge weight, weight loss, Machine, green coffee or notes. The plan's charge, turning point and drop temperatures and its milestone times are read from its reference curve, so to change them, set a different reference: star one of the plan's roasts, or import one from Artisan or Cropster through the … menu at the right end of the plan page's header. Delete is at the bottom of the Edit Plan dialog. Plans cannot be re-ordered by hand. From Rostoc 0.4.8 the Plans page is a table: by default the plans roasted, used or edited most recently come first, and a click on the Name, Batch size, Roasts or Last roasted header sorts the whole list by it. Search plans and the Coffee, Machine and Last roasted filters narrow it.Setup HelpExporting A Roast: What The CSV, JSON And .alog HoldAny roast can be downloaded from its batch page: the … menu at the right end of the page header, then Export as CSV, Export as JSON or Export as .alog. The download starts straight away and the file is named after the roast. The CSV opens with the roast's record, one item per row, name in the first column and value in the second: batch code, roast name, when the roast started (in UTC), Machine, Roasting Plan, green coffee, Lot, roaster name, input weight, output weight, weight loss, colour reading, colour scale, the roast duration from Charge to Drop, where Charge falls on the curve's clock, charge temperature, turning point, dry end, first crack and second crack times, drop temperature, development time, DTR and notes. A blank row follows, then the curve: one column per channel the machine recorded, each headed with its unit, one row per reading. Every record row is written even when it was never filled in, so an empty value means nothing was entered or recorded. Weights in the record are in grams and its temperatures in °C, whatever units the roaster works in. Milestone times count from Charge, as the batch page shows them; the curve's Time column counts from when recording started. The JSON holds the same record and curve, plus the milestones, control changes and timed comments on one timeline. Control changes and timed comments are only in the JSON. The .alog file is for profile-design tools that import roasts in that format, such as Loring's Roast Architect (File > Import), to start a new profile from a Rostoc roast. It holds the bean and environment temperatures, the milestones (Charge, dry end, first crack start and end, second crack start and end, Drop, and the turning point), the roast name, green coffee, notes, roaster name and the input and output weights in grams. Its temperatures stay in the unit the machine recorded, °C or °F. Other channels, control changes, comments, colour and the Lot are not in it. A roast with no bean temperature cannot be exported as .alog.Setup HelpFinishing, Closing Out, Reopening and Moving a LotFrom Rostoc 0.4.8, every change to a Lot's stock is recorded with a reason. - Finish sets a Lot to zero. If the Lot still shows stock, Rostoc asks why and records one row that brings it to zero. That row reads Closed in the Lot's history. A difference of 100 g or less is routine, so Bag-end difference is already chosen. A Lot already at zero finishes at once. - Close out appears on a finished Lot that no longer reads zero, for example after a roast recorded on it after the finish (Roasted after finish). It records the row back to zero, and the Lot stays finished. - Reopen undoes the closing rows, so the Lot holds what it held before it was finished. Those rows read Reopened. - Adjust stock starts from a reason: Roast not recorded in Rostoc, Entered by mistake, Count or weighing, Sample or loss, New delivery, Moved to another lot, or Other (which needs your own words). A finished Lot cannot be adjusted, split or moved: reopen it first. - Move to another warehouse moves a whole Lot. Its stock does not change, and the history records it as Moved. Edit Lot shows the warehouse but no longer changes it.Setup HelpGreen Coffee Orders, Receiving, Due Diligence And SourcingOn the Growth plan, Rostoc follows green coffee from the order to the Lots it becomes. From Rostoc 0.4.9 every order has its own page, under its coffee, that shows where it stands and its next step, what was ordered against what arrived, the Lots it became and a history of changes. Two pages in Inventory help keep the books: Sourcing (orders and suppliers) and Due diligence (every change made to stock or an order by hand). Both are in the … menu at the top right of the Inventory page.Setup HelpReading Rate Of RiseSettings → Roasting controls how Rate of Rise is written down: the interval it is stated over — per minute, or per 30, 15, 10 or 5 seconds — and the scale the line is drawn against, so a fast sample roaster stops running off the top of the chart. Neither setting changes how Rate of Rise is calculated, only how it is read. There is no customer-facing smoothing control.Setup HelpRecording Weight, Colour And Notes After A RoastWhen a roast finishes, Rostoc asks for its finish weight. The confirmation leads with Review batch, which opens the roast's record with the output weight ready to correct — Rostoc fills it in from the plan where it can, so this is the moment to enter what the scale says. The confirmation clears on its own after a few seconds; if it is gone, open the batch and use Edit batch in the page header. Edit batch holds the roast record: Output Weight, Colour Reading, Colour Scale, Notes and Roaster Name. Anything that moves green stock — the plan, the blend, the lots and the input weight — is behind Adjust green & inventory in the same dialog. Charge and drop temperatures come from the roast itself and are shown on the batch page rather than typed in. Home's Needs Attention list carries recent roasts with no drop weight recorded.Setup HelpWhich Roast Metrics Rostoc ShowsA batch record carries the roast curve, milestone events, phase timings for drying, Maillard and development, charge and drop temperatures, weights and notes. Rostoc also computes area under the curve — thermal load — for every roast and uses it when judging how consistent a roast is against others, but it is not displayed as a figure you can read off the batch page today.Setup HelpZooming And Panning The Roast ChartThe roast chart zooms. On a saved Batch and on the live chart in Roast Studio, pinch on a trackpad, or hold Ctrl (Cmd on a Mac) and scroll, to zoom in on time and temperature together around the pointer. Drag the plot to move around the roast. Reset zoom, in the top-left corner of the plot, brings the whole roast back. Zoom only changes how the Curve is drawn: nothing in the Batch is changed or saved, and the shared image always shows the whole roast.