← Back to home

Getting started

Your first night, from a board still in its box to a finished image you can share. Polaris runs on the rig and you drive it from a phone, a tablet or any browser. This is the short path: get in, let it find your equipment, focus, frame, guide, shoot, and finish the picture without moving the files anywhere.

First, get in

Polaris runs on the rig and answers on the network. Three ways in, depending on where you are.

Phone or tablet app

Install the app for Android or iOS from the Download page. It finds the boards on your network by itself and connects with one tap, so there is no address to type. On a phone the interface becomes Field Mode, a touch shell made for standing next to the scope in the dark.

Any browser

Point any phone, tablet or laptop at the rig's address on port 5000, by hostname or by IP, and accept the self-signed certificate once.

https://<ip-or-hostname>:5000

First boot, before any network

A freshly flashed card comes up as its own WiFi hotspot, named Polaris-Hotspot plus four characters from the adapter's MAC, password polaris1234. Join it, open the address above, choose your password, then tell Polaris where you are and which WiFi to use. Everything after that happens on your own network.

  1. 1

    Let the wizard find your equipment

    The first time you open Polaris it offers to set the rig up for you. It probes what is plugged in, through INDI on Linux and through ASCOM or Alpaca on Windows, shows you what it found, connects it, and asks only for what no driver can tell it, such as focal length. Skip it and do everything by hand in RIGS if you prefer, and call it back from the Setup wizard button there whenever the gear changes.

    TipNo INDI driver for your camera or focuser? Install it from inside Polaris, in the INDI card under RIGS. It offers only packages built for the INDI already on the host, and refuses any install that would remove something you are using.

    Let the wizard find your equipment
  2. 2

    Check the rig

    A rig is one whole setup saved under one name: telescope, camera, mount, focuser, filter wheel, guide scope and accessories. Pick your telescope by brand and model and the focal length and aperture fill themselves in, add the reducer or flattener if you use one, then Save selections. Framing, plate solving and guiding scale all come from these numbers.

    TipKeep one rig per physical setup. Switching rigs switches every default with it, so a second scope is one dropdown away rather than an evening of re-typing.

    Check the rig
  3. 3

    Connect, and recover when something vanishes

    On each card, choose the driver under the connection strip: INDI on Linux, ASCOM or Alpaca on Windows, or a native SDK for ZWO, SVBony, Player One, ToupTek and Altair cameras. Set the cooler target, connect each device, and check that the mount is tracking and the filter names match what is in the wheel.

    TipWhen a device drops off the bus mid session, Reset USB in the INDI card re-enumerates the bus and restarts the drivers, which is the software version of walking out and replugging every cable. It never touches the disk the board boots from.

    Connect, and recover when something vanishes
  4. 4

    Get sharp focus

    Open FOCUS and run the V-curve: choose a step size and a sample count, press Start AF, and Polaris samples both sides of focus, fits the curve and parks the focuser at the minimum. With a filter wheel it keeps the offset per filter, so the next filter change does not cost you another sweep.

    TipPrefer a mask? Put a Bahtinov on the aperture, start the video stream and switch the Bahtinov panel on: it reads the offset about four times a second and tells you which way to turn, without taking an exposure of its own.

    Get sharp focus
  5. 5

    Frame the target

    Open SKY and search for the object, or take a suggestion from TONIGHT, which ranks what is actually up from your site on this date. Slew and Center slews, plate solves and corrects until the target sits where you want it inside the field overlay. The rotation slider sets the angle, and with a motorised rotator Polaris turns it for you.

    TipThe sky map and the catalogs live on the host, so framing and plate solving work with no internet at all, which is the normal condition at a dark site.

    Frame the target
  6. 6

    Start guiding

    GUIDE runs Polaris's own guider: connect the guide camera, Loop, calibrate once near the meridian and the equator, then Guide. Graph, star profile, multi-star, dithering and settling are all there, and the correction maths follows PHD2's algorithms, so nothing extra has to be installed.

    TipAlready have a PHD2 setup you trust? Connect Polaris to it instead, and open the embedded PHD2 window when you want the original interface.

    Start guiding
  7. 7

    Shoot: live stacking or an autorun

    For results while you are still at the scope, LIVE stacks each frame as it lands, calibrated and aligned, and the object comes out of the noise in front of you. For a full night, AUTORUN takes a list of sets, each with filter, exposure and count, with dithering, meridian flip and end actions. Both write the subs to disk, and you can close the browser: the run belongs to the host, not to your tab.

    TipEnd actions can park the mount, warm the camera, run background extraction on what you shot and upload the night, so the morning is a folder that is already sorted.

    Shoot: live stacking or an autorun
  8. 8

    Or hand the night to PLAN

    PLAN is for a night with more than one target. Tell it what you want and how much of each; it works out when each object is high enough, orders the night around meridian flips and your horizon, and runs it. If guiding loses the star, it holds and picks the target back up when the star returns, instead of throwing the target away.

    TipCustom horizons are supported, so a tree line or the neighbour's roof is part of the plan rather than a surprise at two in the morning.

    Or hand the night to PLAN
  9. 9

    Finish the image, and get it off the board

    STUDIO turns the subs into a picture: masters from your calibration frames, then calibration and integration of the lights, background extraction, denoise and deconvolution with the AI tools, colour calibration against a star catalog, and star removal and blending when you want them. The EDITOR handles tone and colour, and exports to JPEG, PNG or 16-bit TIFF.

    TipA night lives on one card until you copy it somewhere. Storage push sends a finished run to a NAS or to Drive, OneDrive, Dropbox, Nextcloud, SFTP or S3, and the copy on the host always stays where it is.

    Finish the image, and get it off the board

That is the whole loop

This page is the speed run. The handbook walks through every tab in depth, and the install guide covers the optional pieces: plate solvers, star catalogs, the AI models and PHD2.