Skip to Content

Frequently Asked Questions


StellarMate FAQ

Answer

To install StellarMate OS on any VM, you should activate EFI booting.

For Proxmox, you also need to disable the Pre-enroll Keys for the EFI Disk

View question
Answer

For mw4 there are installation instructions at MWorion

In summary:

1) in stellarmate directory using terminal type: curl -LsSf https://astral.sh/uv/install.sh | sh

2) mkdir mw4

3) cd mw4

4) uv venv -p 3.13

5) Check to make sure you have `.venv` dir: ls -la

6) uv pip install mountwizzard4

7) uv pip install https://github.com/mworion/mountwizzard4/raw/main/wheels/PyQt5-5.15.9-cp38.cp39.cp310-abi3-manylinux_2_17_aarch64.whl

8) To run the program, go to the mw4 directory and run: `uv run mw4`

View question
Answer

1) Download astap and d50_star_database files.

2) sudo pacman -U astap_aarch64.pkg.tar.zst

3) sudo pacman -U d50_star_database.pkg.tar.zst

4) Download astap_cli

5) renamed astap-cli to astap

6) sudo cp astap /opt/astap/

View question
Answer
 

Bootloader update required

If the unit is not booting or you cannot access it via VNC, your Raspberry Pi bootloader is likely out of date. Update it first using Raspberry Pi Imager. Follow the official HOWTO.

View question
Answer

Forrest Yelverton gracieously provided this HOWTO on how to get any TSX version beyond 13823 running on my StellarMate OS 2.0+.

Error was missing linked library:
libicui18n.so.72 => not found
libicuuc.so.72 => not found

The required packages to resolve this are Debian based:
http://deb.debian.org/debian/pool/main/i/icu/libicu72_72.1-3%2bdeb12u1_arm64.deb

Please follow these steps:
1. Disable StellarMate OS atomic updates since 3rd party package installation is disabled by default:

sudo /etc/stellarmate/atomic-updates.sh --disable

2. Install "debtap" with:

yay -S debtap

3. Download the DEB package above. File will be libicu72_72.1-3+deb12u1_arm64.deb
4. Move to the directory containing the Deb files just downloaded
5. Run:

debtap libicu72_72.1-3+deb12u1_arm64.deb

6. Run sudo pacman -U libicu72-72.1-1-aarch64.pkg.tar.zst Results in several new folders.
7. Navigate to "DownloadFolder"/usr/lib/aarch64-linux-gnu
8. copy the files to the /usr/lib directory (must use the cp -a to preserve the links)
9. Re-enable atomic updates:

sudo /etc/stellarmate/atomic-updates.sh --enable

There is some possibility that the command from #6 above will put the required files into: /usr/lib/aarch64-linux-gnu directly, in which case you still need to cp -a them into /usr/lib



The required files are shown in the image below

tsx files
You should now be able to update to TSX 13954 and TSX 14036 (most current Linux ARM64 version as of 10 March, 2026

 

View question
Answer

StellarMate OS 2.0+ uses atomic updates to ensure your system is fully updated correctly in one operation and that all system components work together reliably. This approach provides a more stable experience, especially for remote observatory deployments.

For advanced users that required direct access to the underlying Arch-based Pacman repository for custom software installation, you can disable atomic updates by running:

sudo /etc/stellarmate/atomic-updates.sh --disable

Disabling atomic updates will enable third-party software repositories, which could potentially lead to system instability. Only proceed if you understand the risks and are comfortable troubleshooting potential issues.

View question
Answer

It's not possible. StellarMate OS is a completely new unified OS for Raspberry PI and Mini PCs. It must be downloaded and reflashed to to the system.

What’s new in v2.0?

  1. Atomic Updates: safer, smoother system upgrades
  2. Integrity Checks: enhanced reliability and protection
  3. Native NVMe & SD Card GUI Installer: easy graphical installation
  4. Rolling OS with Latest Updates: always up-to-date
  5. Snapshots & Rollbacks: restore your system instantly if needed
  6. Flatpak Stable + Nightly Support: more flexibility for apps and testing

StellarMate OS v2.0 is not a free upgrade for existing users, however all current customers will receive a 25% discount as a token of appreciation for your valued support!

StellarMate Pro & StellarMate X Astrophotography Controllers customers can upgrade to SM OS 2.0 for free by downloading it from the orders page.

View question
Answer

Wayland display protocol is currently not supported in StellarMate OS due to issue with VNC support. Please ignore any requests to switch to Wayland in Raspberry PI OS and stick with X11 until StellarMate OS officially supports Wayland out of the box.

View question
Answer

Yes, the same SD card can be used and swapped at any time between Raspberry PI 4 & 5.

 

View question
Answer

You can change the Screen configuration by following the steps below:

  • Click on the Start Menu
  • Select Preferences --> Screen configuration

You can also check the Video below:

change_resolution-2024-04-28_14.58.02.mp4

 

View question
Answer

This may happen when more than one INDI driver is trying to open the same serial port leading to a deadlock. When a new equipment profile is first started, and there are more than one serial port detected on the system, then the Port Selector window should popup up (on both Ekos and StellarMate App). In this step, you need to select the appropiate serial port for each device. Once done, press Connect All. Skipping this step would cause all drivers to trying establishing communication by iterating over all detedted serial port, and this may lead to a deadlock as indicated before.

There are two approaches to resolve this issue:

  • In Ekos, edit your Equipment Profile and make sure Port Selector is checked and save the profile.
  • In StellarMate App, delete and re-create the equipment profile.

Next time you start the profile, the Port Selector should come up again.

View question
Answer

Yes, you can pay directly with a Debit or Credit card. When redirecting from StellarMate website to Paypal, select Guest Checkout.

How do my website's visitors use PayPal guest checkout? - Primary Image

View question
Answer

Ekos Guide Logs are in PHD2-compatible format and are located in "~/.local/share/kstars/guideLogs".
You can use PHD2LogViewer to view the analysis.

View question
Answer

Yes, Raspberry PI 5 is fully supported.

View question
Answer

There are a few reasons for failing to get a 3D FIX from your GPS dongles.

  • Indoor obstructions. Test with GPS outside with clear access to the sky so that it can communicate with the satellites.
  • USB3 Interferance: If the GPS antenna is is connected close to an active USB3 port (a USB3 port connected to a device like a camera), then the interferance may lead to failure in obtaining a fix. It's recommended to get a GPS dongle with a long wire away from StelarMate to protect against unwanted interferance.
  • Incorrect baud rate: Some older GPS dongle uses a baud rate of 4800. The default baud rate in StellarMate is configured as 9600. Therefore, StellarMate would fail to communicate with the GPS dongle unless the rate is changed within StellarMate to match the GPS dongle rate.
View question
Answer

If you have purchased StellarMate from a retailer, please submit a new ticket and attach your order receipt and tell us if you don't see an order in the Orders page.

To be able to use a different MicroSD than the already built-in one, you need to flash StellarMate OS onto your MicroSD.

1. Login to the stellarmate.com website and then go to the Orders page.

2. You should see a list of  your orders. Click on your order link, then scroll down to see the downloads. Make sure to download the SM OS version appropiate for your hardware platform.

orders page

3. Download balenaEtcher, and install it, then open it.

balenaEtcher download

4. Connect an SD card reader to your computer with the MicroSD card inside.

5. Open Etcher and select from your hard drive the StellarMate OS  .xz file you just downloaded to write it to the MicroSD card.

balenaEtcher flash from file

balenaEtcher flash from file dialog

6. Select the MicroSD card you wish to write your image to.

balenaEtcher select target

balenaEtcher select target dialog

7. Review your selections and click 'Flash!' to begin writing data to the SD card.

balenaEtcher flash

8. When it's done, connect the MicroSD to StellarMate and power it up!

View question
Answer

Absolutely. After you connect the external USB drive, use SM App to connect to StellarMate and start an equipment profile.

Then go to Capture module and File Settings

smapp externalstorage

 

 Tap the external storage name and it would be set as the default location for the Pictures directory. Restart StellarMate for the change to take effect.

If the USB storage is not detected by StellarMate, it will fall back to the default /home/stellarmate/Pictures directory

1. Using KStars on StellarMate

if you are running KStars inside StellarMate directly, then simply browse the location in the Directory filed of the Capture Module. You can also paste the URL there directly.

kstars in stellarmate

2. Using KStars on Windows/MacOS/Linux

If you are running KStars remotely on a Windows/MacOS or Linux machine, then in this case you need to change the Upload mode to either Local (save images only in StellarMate) or Both (save images in StellarMate and send a copy to us). 

kstars on pc

You will see the Remote field getting enabled for editing. Simple paste the location URL here and start the capture process to have your images saved to the external USB disk.

 

View question
Answer

The following is a list of checks you need to verify before contacting support regarding DSLR connectivity issues:

  • Make sure the camera battery is full.
  • Make sure there is enough space on your SD card.
  • Make sure the camera is set to Bulb/Manual mode. In some models you need to rotate the dial first to Manual then change the setttings to make it Bulb.
  • Turn off any power-saving features in the camera that might be making the camera go to sleep mode without your knowledge. Some cameras support inactivity timer, try to set it to 10 or 15 minutes to be on the safe side.
  • Try a different USB cable.
  • Try plugging the camera to a different USB port on StellarMate.

If none of the above works out, please submit a support ticket with details on your setup.

View question
Answer

StellarMate Gadget already ships with RTC clock configured and ready to go. For users of StellarMate OS running on their RPI3/RPI3B+, you can purchase a DS3231 module and install it. There is no need to perform any additional software configuration as StellarMate OS supports DS3231 natively.

View question
Answer

If you captured images and saved them to StellarMate, then they should be available by default under /home/stellarmate/Pictures. To access the images over the network, there are two options:

  • On Windows, click on the Network icon in the left pane of File Explorer as illustrated below.

windows access stellarmate

Windows 11 users may have issues accessing Samba shared over the network. Please follow this extenstive guide on how to make it work again.

If you do not see the StellarMate network share, please map the network drive as shown in this video:

add_pictures_share.mp4

  • On Linux & MacOS: Use FileZilla to connect to StellarMate via Secure FTP (sftp) using your username (stellarmate) and password (smate). Remember to set port to 5624.

stellarmate sftp settings

View question
Answer

It is possible to connect to StellarMate directly without going via a router. Simply connect an ethernet cable from your PC/Mac to StellarMate. There is no need to use a crossover cable, any regular Ethernet cable would do. You can access StellarMate as you would normally do via the address http://stellarmate.local

Using the App or StellarMate Dashboard, you can set StellarMate to Direct Ethernet mode. In this mode, StellarMate IP address is set to 192.168.100.1

Using your OS network configuration tool, Change your Network Adapter IP settings to the following:

  • IP Address: 192.168.100.2
  • Subnet Mask: 255.255.255.0
  • Gateway: 192.168.100.1
  • DNS: 192.168.100.1

windows static ip settings

After applying the settings, you can access StellarMate either via http://stellarmate.local or via http://192.168.100.1 address.

View question
Answer

No.

StellarMate is based on Open Astronomy Instrumentation Protocol (INDI) and does not use ASCOM. INDI enables native remote control of your equipment and numerous devices are supported by manufacturers today. Ekos is the officially supported client, but you can also use over 15+ clients on across many operating systems.

View question
Answer

StellarMate ships with 32GB MicroSD card. Images are saved by default to the internal SD card. It is possible to change the default Pictures directory (/home/stellarmate/Pictures) to a different location using either StellarMate Tools or StellarMate App.

StellarMate Tools via VNC

stellarmatetools

Once the Pictures Directory is set, KStars and Network Storage is updated to the new directory. StellarMate requires a restart for this to take effect.

StellarMate App

From StellarMate App Capture Module, toggle File Settings to change the default Pictures directory or set it to an external storage.

smapp externalstorage

KStars on PC/Mac

If you are using Ekos on PC/Mac, then you need to set Upload mode to Local and then set the Remote Directory to /home/stellarmate/Pictures as illustrated below:

thumb windows stellarmate local

2. If you are using Ekos directly on StellarMate, simply set the Directory field in the capture module to /home/stellarmate/Pictures. The Upload mode should remain as Client.

/home/stellarmate/Pictures is case sensitive. Make sure not to set it by mistake to /home/stellarmate/pictures

View question
Answer

Yes. Stellarmate does not use the default SSH port. Use port 5624 to login to StellarMate using your username and password.

ssh -p 5624 [email protected]

The same port should be used for SFTP (e.g. in FileZilla). You can perform remote update using the following command:

sudo apt-get update && sudo apt-get -y dist-upgrade
View question
Answer

Use Web-Based VNC Viewer or any VNC Viewer to access StellarMate. Simply double click the Software Updater icon to fetch updates. If there are any available updates, a window shall appear with the required upgrades. Click Install to download and install them. It is recommended to restart the unit after installation updates.

stellarmate update

If for any reason you are having problems with the GUI Software Updater, you can directly write a command to start update process. Double click the Mate Terminal icon and a terminal window shall be opened. Type in the following command and press enter:

sudo apt-get update && sudo apt-get -y upgrade

stellarmate console

View question
Answer
Answer

If you using StellarMate Web Manager, please add SkySafari driver to your Auxiliary drivers. From within Ekos, select SkySafari from Auxiliary.

sky_safari.mp4

For complete instructions, please visit SkySafari INDI support page.

View question
Answer

By default, the unit hostname is stellarmate.local

From StellarMate App, go to My Mates then select your unit. The hostname is the unit name. If you changed the unit name, then just use the name followed by .local

For example, if you changed the unit name to observatory, then your new hostname is observatory.local

Another way to find the hostname is to open the Web Manager from the StellarMate App and you will see the unit hostname in the browser address bar.

View question
Answer

StellarMate WiFi HotSpot password: stellar@mate

To change default password, follow the steps in this vide:

change_wifi_password.mp4

View question
Answer

The StellarMate WiFi Hotspot by default operates at 5Ghz. While this offers better speed, it offers relatively shorter distances compared to 2.4Ghz. You can use StellarMate App to switch the default Hotspot Frequency (2.4Ghz or 5Ghz) and select the channel (in case of channel congestion). As with any WiFi-enabled device, the signal strength and reliability can be affected by several factors:

1. Power Supply: For StellarMate running on Raspberry PIs, you need to use a 3A+ 5V power supply (3 Amperes or higher) in order to properly operate the OS. Anything less than 3A could result in system instabilities and possible corruption. To solve this problem, invest in a reputable power supply before you boot StellarMate OS. For StellarMate Pro and StellarMate X controllers, the official power supply is suffcient.

2. Congestion: if there are many WiFi Networks in the area surrounding StellarMate, the WiFi Hotspot might be slow due to signal and channel congestion. A possible solution in case of severe interference is to toggle WiFi frequency (2.4Ghz/5Ghz) in StellarMate OS and try to locate a channel that is relatively free of congestion.

3. Obstructions: If you used a metal case for StellarMate or the unit is attached to a metal surface, this can attenuate the signal. Try to keep StellarMate separate from any nearby metallic objects.

4. USB 3.0: There is a known issue with USB 3.0 ports causing significant interfaces with 2.4Ghz signals. If an active USB 3.0 port is used by any peripheral, it may lead to signal degradation. There are two methods to resolve this issue:
4.1 Connect USB 3.0 peripherals to the StellarMate USB 2.0 port
4.2 Switch StellarMate OS WiFi HotSpot Frequency to 5Ghz range which is immune to this interference from USB 3.0.
5. HDMI Resolution: If you connect StellarMate to an external display using an HDMI cable, then high resolution is known to cause interference with WiFi. Try to lower the HDMI resolution to improve the situation.

If none of the above solutions work, another possible solution to to try using a Wired Connection using Ethernet Cable. This can be achieved via a direct Ethernet connection between StellarMate and your PC/Mac, or via a router. It is a last-resort solution but is known to be reiable and almost 10 times faster than WiFi.

View question
Answer

StellarMate HotSpot is only active when StellarMate is not connected to any WiFi network. By default, the StellarMate Hotspot operates at 5Ghz WiFi (not 2.4Ghz). Therefore, your phone/tablet/PC must support 5Ghz WiFi. It is possible to switch StellarMate WiFi to 2.4Ghz but you need to use SM App to switch and you need a 5Ghz WiFi capable device first to connect to it.

Common Issues

1. Insufficient power: You must use a reliable power supply that can deliver 5 volts at 3 (for RPI4) and 5 (for RPI 5) Amperes. If powered via battery, make sure it can consistently deliver 3A to StellarMate.

2. Failure to boot: Check if StellarMate is booting. For Raspberry PI, the green LED should NOT be solid green all the time. If it is solid green, this indicates an SD problem and you should probably try another SD card and verify the SM OS image checksum. To know the exact failure, connect StellarMate to an external monitor with HDMI. If you see KStars on the monitor, then this indicates boot was successful and the hotspot problem is not boot-related. However, if you see a black boot screen with messages, then capture an image of the monitor with your phone and send it to support in a ticket.

3. Noisy WiFi Environment: In case you have a very active and noisy WiFi environment (many WiFi network), it can overwhelm the WiFi controller in StellarMate and it cannot generate a proper hotspot. Try to get away from very noisy WiFi environments to have a successfully HotSpot.

4. Metal Enclosures: If using StellarMate OS with your own Raspberry PI with a metal case, then it can lead to attentuation of WiFi signals. Try to use a plastic enclosure.

5. Close Promixity to other electronic devices: Some users reported HotSpot signal loss when StellarMate is stacked with other devices like monitors or USB hubs. Try to maintain at least 15 cm away from any other electronic device that can cause interferance with the HotSpot Signal.

6. USB 3.0: There is a known issue with USB 3.0 ports causing significant interfaces with 2.4Ghz signals. If an active USB 3.0 port is used by any peripheral, it may lead to signal degradation. There are two methods to resolve this issue:
6.1 Connect USB 3.0 peripherals to the StellarMate USB 2.0 port
6.2 Switch StellarMate OS WiFi HotSpot Frequency to 5Ghz range which is immune to this interference from USB 3.0.

7. HDMI Resolution: If you connect StellarMate to an external display using an HDMI cable, then high resolution is known to cause interference with WiFi. Try to lower the HDMI resolution to improve the situation.

If you have trouble connecting StellarMate to your router via WiFi, please access your router and clear all cache and any entries for StellarMate.

View question
Answer

To reset StellarMate, use go to StellarMate Control Panel (stellarmate.local) and click on the Diagnostics icon on the side menu as illustrated below:

reset_factory.mp4

After clicking the icon, the diagnostics tab will open with lots of options including:

  • Reset Network: Click this button to reset WiFi settings in case you have issues accessing the unit via WiFi or HotSpot. It will restore StellarMate to HotSpot mode.
  • Reset Factory: Click this button to reset all settings, including WiFi. This action is irreversible! Please make sure to backup any important data on the SD card!

StellarMate must now be restarted for the above to take effect.

If you have trouble connecting StellarMate to your router via WiFi, please access your router and clear all cache and any entries for StellarMate.

View question
Answer

username: stellarmate

password: smate

View question
Answer

There are many mobile and desktop applications that you can use to control StellarMate. For a complete list, please check INDI Clients page.

However, only Ekos and StellarMate App are officially supported.

View question
Answer

No, it's not broken. That's the normal behavior. Here are what the LED lights mean:

Red LED

  • Keeps steady on when powered.
  • Flashes if the power drops below ~4.63V.

Green LED

  • Steady on if no SD card during boot.

  • irregular flashes for SD card access.

So if the Green LED is off, it means there isn't much activity going on. If you cannot detect StellarMate HotSpot on your phone, please use the supplied HDMI cable and connect it to an external TV/Monitor. Check what you get on the TV:

  • If you see StellarMate OS desktop, then the unit is working fine. Check the network settings. stellarmate tools
    1. Attach a keyboard and mouse (wireless would work as well).
    2. Click on StellarMate Tools App.
    3. Click on Network Reset. Confirm network reset.
    4. Reboot the unit.
  • If you see error messages on the console, there there is a problem in booting up the Operating System. If you have StellarMate OS image, then the best course of action is to reflash the image. Check the integrety of the microSD cards as they tend to degrade with time. If you do not have StellarMate OS image, Contact support so we can help you resolve this issue.

 

View question
Answer

The maximum reported SD card size is 128GB.

Make sure to use a reputable class 10+ SD card.

View question
Answer

You can connect to StellarMate via the following methods:

  • Direct Connection: Plug the supplied HDMI cable to a monitor to gain direct access to StellarMate OS. You also need to plug your Mouse & Keyboard.
  • Wired: Connect StellarMate to your LAN via Ethernet. You can access it like any other device on your network. You can use Network Discovery tools on your operating system (e.g. Avahi/Bonjour). to detect it as it advertises its services over the network.
  • Wireless: Use StellarMate App for Android and iOS to connect to your gadget.
View question
Answer

Absolutely! StellarMate works with all variants of RPI4. We recommend you purchase the 4GB version.

View question
Answer

After you purchased StellarMate OS, you should receive a confirmation email with links to the downloads. In the future, if you want to download StellarMate OS again, make sure you are logged in to the stellarmate.com website and then go to the Orders page.

You should see a list of  your orders. Click on your order link, then scroll down to see the downloads. Make sure to download the SM OS version appropiate for your hardware platform.

In case you have an issue with flashing the image with Raspberry PI imager, please follow these steps:

  1. Using the Raspberry Pi Imager install Misc Utility Images -> Bootloader -> SD Card Boot.
  2. Move card to RP and boot, power off, removed card.
  3. Erase card using Raspberry Pi Imager, remove card from computer and insert again.
  4. Using Raspberry Pi Imager install the StellarMate image. 
View question
Answer

You need equipment (Mounts, Cameras, Focuser...etc) that can be connected to a computer via either USB, Bluetooth, or Ethernet. All modern gadget include connectors to computers. For mount with Serial connectors, you will need to purchase a Serial-2-USB adapter. Since StellarMate uses INDI for device control, you need to make sure your device is supported. While not strictly required, it is highly recommened to use an external powered USB hub to connect your devices to.

To use the StellarMate App, you need either an Android or iOS based smart phone.

View question
Answer

The gadget include several methods that enables you to connect your equipment. StellarMate communication channels include 4x USB 2.0 ports, 10/100 MBPS Ethernet, 802.11n Wireless LAN, and Bluetooth 4.0. You connect your equipment to StellarMate using any of the supported communication channels. Once connected, you can use a mobile (Phone & Tablet) or desktop (Windows, MacOS, Linux) application to control your equipment.

StellarMate Connection Diagram

View question
Answer

StellarMate is a small mobile astronomy gadget that you can connect your astronomy devices to. It enables you to control your mount, camera, focuser, filter wheel, dome, and many more devices. Designed for astrophotgorahy, it includes free powerful astrophotography tool that supports mount control, batch capture, autofocus, autoguide, and astrometry.

View question
StellarMate App FAQ

Answer

Starting with StellarMate App v3.0, StellarMate switched to a different management server for license data. If stale license data is encountered, you might receive this error.

The data can only be refreshed after signing in again to the App. Therefore, there are two approaches:

1. Go to Settings --> Logout and close the App and sign in again to refresh the data.

2. Completely uninstall and reinstall the App to ensure there is no residual cache left that might affect this issue.

View question
Answer

StellarMate is probably the most verstile astrophotogaphy controller in the world. We offer multiple ways to control your equipment the way you prefer.

StellarMate App is only required for the intial setup of your device. Therefore, after you SCAN and connect to your StellarMate unit and the connection led turns green, your unit setup is complete.

You can then continue to use StellarMate App to control your unit, or select one (or more) of the following methods:

1. Download KStars on Windows/Mac/Linux and connect remotely to StellarMate.

2. Access StellarMate OS via VNC (using either Web VNC or VNC clients like RealVNC) or Rustdesk, and use KStars that is already running inside StellarMate.

3. Control it completely from EkosLive Online web interface.

View question
Answer

By default, the scheduler is designed to run on multiple nights. Therefore, when started, it tries to continue from where it was left on. If all the sequence images are already captured and stored on disk, then it will declare that all jobs are complete. If you would like to start anew, there are a couple of options:

  1. Move, rename, or delete the captured images folder.
  2. Edit the sequence file and change the storage location to a different location.
  3. Disable Remember Job Progress setting in Scheduler Advanced settings.

remember job progress

View question
Answer

If you signed up with Google/Apple social login, the system generates a random password in the site. For website login this is sufficient. However, StellarMate App requires username and password login since it can operate in totally offline mode. Therefore, after signing in to stellarmate.com, go to your Profile and set your own password. Use this password for logging in StellarMate App.

profile

View question
Answer

Every time you connect to StellarMate, it sends a token that the App uses to login to the device. Sometimes, the App uses an old token whereas a new one was generated by the system. The solution is simple, just tap stellarmate again to force a re-login.

View question
Answer

It's not wrong. INDI uses a different convention to represent longitude. Longitude is 0 to +360 increasing eastwards. For example, if you longitude is 80 West, then in INDI it is represented as (360-80) = +280

View question
Answer

Usually this message is displayed when there is a communication or login error between your phone/tablet and StellarMate. A popup notification would show the exact error. Try to check the following steps:

I. Login Issues

  1. If the reported error is about authentication:
    1. Go to Settings tab --> Reset App.
    2. Restart App
    3. Sign in
    4. RESCAN for StellarMate
    5. Connect Again
  2. If #1 does not solve the authentication issue then login to StellarMate Via VNC and launch StellarMate Tools app on the desktop then click Reset EkosLive. Reboot stellarmate.

II. Communication Issues

  1. If you have Mobile Data enabled on your phone, then disable it as this might interfer with your connection to StellarMate Hotspot.
  2. Double check you are fully connected to the hotspot, sometimes Android/iOS do not fully connect, check network settings for any warnings. If possible, click Keep This Connection.
  3. Check if you can reach StellarMate WiFi using your tablet browser. Open the browser and then go to http://10.250.25.1 You should see StellarMate Dashboard if all connection is OK.
  4. If no response at all after reboot (i.e. not hotspot created), try to connect HDMI cable to the mini-HDMI port closest to the USB-C power port and connect it to an external monitor. Do you see any messages? Please send a screenshot to support.
  5. If all above fails, you can try re-flashing StellarMate OS image unto the SD card (or a new SD card).

If the StellarMate App seems to be stuck on the authentication step, sometimes simply tapping stellarmate again should resolve the issue.

View question
Answer

Live Stacking image can be saved to the Tablet/Phone storage or photo gallery by clicking on the save button in the LiveStacking options as illustrated below:

livestacking

Please note that the Live Stacking images are already saved to StellarMate internal storage and can be accessed via the View tab or via browsing SM shared network drive. All Livestacked images are automatically tagged with #livestacking tag so you can easily search for via the tag.

View question
Answer

Please check the following suggestions:

  1. Ensure that you can see stellarmate HotSpot network name in the list of networks detected by your tablet. If the stellarmate network is not listed, then check that StellarMate is properly powered.  Use the HDMI cable to connect the unit to a nearby monitor/TV and check for any error messages. Take a photo of the error and open a support ticket in order for our technical support to help you further.
  2. Ensure Tablet is connected to the HotSpot (default password is stellar@mate) or connected to your Home WiFi if StellarMate Controller was joined to the Home WiFi network before. If the tablet is connected to your Home WiFi, do you know its IP address? You can add a device manually by its IP address.
  3. Open http://stellarmate.local or http://10.250.250.1 from your Tablet/Phone browser and see if you can reach StellarMate Dashbaord. If it fails to reach, then the communication is not established between your Tablet/Phone and StellarMate Controller.
  4. Open StellarMate Web Manager at http://stellarmate.local:8624 or http://10.250.250.1:8624. StellarMate Web Manager is required to connect to StellarMate App. If the Web Manager is not responding then this could indicate an issue in either the connection or StellarMate OS itself (corrupted image or disk). Connect HDMI cable and look for any messages on the screen and send them to support.

Mobile data can sometimes prevent communication to Hotspots. Disable Mobile Data and check if StellarMate is detected correctly.

If none of the above suggestions work, you can always reflash StellarMate Controller with a fresh SM OS image. Please note that flashing an image erases all the existing content on the StellarMate Controller storage.

View question
Answer

While a view to the celestial pole is desirable, it's not strictly necessary. The App would work almost anywhere in the sky, prefereably closer to the meridian.

View question
Answer

Yes. It is possible to do this by following these steps:

In StellarMate App

  1. Start your equipment profile.
  2. That's all

In Ekos on PC/Mac

  1. Make sure you are connected to the same network as StellarMate.
  2. Create a new equipment profile with the same drivers started in the App equipment profile.
  3. Set the profile to remote and the host to stellarmate.local
  4. Make sure INDI Web Manager is UNCHECKED. This is very important.
  5. Save and then click start.
  6. Done!

Ekos Equipment Profile

 

View question
Answer

The Serial Number and Licence Key for the Stellarmate App are listed in the Licence Management page.

  • If you purchased StellarMate Controller, then the Serial Number can be found on the bottom of the unit. You need to enter the Serial Number in the Licence Management page to generate a license key.
  • If you purchased StellarMate OS, then the Serial Number and Licence are automatically generated for you. So just go to the Licence Management page to view them.

If you purchased StellarMate OS or StellarMate Controller before June 1st, 2019, then in order to use the StellarMate App you must download StellarMate OS v1.4.0+ and burn it to the StellarMate SD card.

View question
StellartMate Pro FAQ

Answer

SM Pro internal storage can be flashed with a new SM OS image is desired. This requires opening the case and flashing the image to the mSATA storage inside as per the following steps:

1. You need an mSATA reader/writer (Similar to this product on Amazon)
2. Unscrew the case and carefully. There are 4 screws securing the case. Once done, carefully lift the lid as there are pigtails connecting the GPS + WiFI antennas to the board and we don't want to accidentally snap them.
3. You should see the mSATA SSD on the left side with two small screws. You can simply unscrew them and take out the SSD.

smpro cm4

4. Attach the mSATA SSD into the reader/writer purchased in step #1
5. Download SM Pro OS

Use Raspberry PI Imager to flash the downloaded image to the mSATA, then secure the mSATA again into SM Pro and close the case.

Do not customize any settings. Select your device (the mSATA) then select Custom Image:

Screenshot 20230513 133921

The SM OS should then work on next power up. In case you have issues with any equipment, please connect SM Pro to the internet and enable Rustdesk and send us the ID. This remote support would help us to login and diagnose any issues.

View question
Answer

By default, SM Pro remembers any changes made to the power outputs so that next time the unit is turned on, it would automatically restore the power outputs to their previous state. This behavior is suitable for mobile setups since you would start using the equipment soon after powering on SM Pro.

However, for permenant observatories where SM Pro can be powered all the time, it may be desirable to only power connected devices like Mount, Camera,..etc before starting an equipment profile. To turn on power automatically to your equipment before the equipment profile is started, add a rule to the Profile Scripts Editor found in the Equipment Profile dialog in Ekos. Click on Scripts button and then add a rule, select @localhost:12624 (which is the dedicated INDI SM Pro driver running on port 12624) and then select the appropiate delay in seconds after establishing the connection (example: 5 seconds).

smpro connect startup

Please note that this feature only work when Power Off is toggled in the SM Pro driver Power tab. When enabled, Power Off turns off power whenever the driver is disconnected, which typically happens when the Ekos profile is stopped. If you manually power off your devices, then your devices can only be turned on manually.

power off enabled

If you are using KStars from a remote PC/Mac then the remote driver should include StellarMate Pro hostname or IP address: @stellarmate.local:12624 or @ip_address:12624

View question
Answer

The StellarMate Pro utilizes a passive GPS antenna for accurate time and location data. To achieve optimal performance, adhering to the following guidelines is recommended:

Environmental Requirements

  • Unobstructed View of the Sky: The GPS antenna requires a clear line of sight to satellites for reliable signal reception. Avoid placing the StellarMate Pro near structures, trees, or other obstructions.

Mitigating Electromagnetic Interference

  • USB 3.0 Devices: Certain USB 3.0 devices can generate electromagnetic noise that may disrupt GPS signal acquisition. It is recommended to:
    • Utilize high-quality, double-shielded USB 3.0 cables when necessary.
    • Disconnect all USB 3.0 devices during initial GPS lock procedures.

Standalone GPS Lock Procedure

  1. Power Off: Ensure the StellarMate Pro is powered off.
  2. Disconnect USB 3.0 Devices: Disconnect all USB 3.0 devices from the StellarMate Pro.
  3. Open Sky Placement: Position the StellarMate Pro outdoors in an open area with a clear view of the sky.
  4. Power On and Wait: Power on the StellarMate Pro and allow approximately 60-90 seconds for GPS signal acquisition. A solid illumination of the USR LED indicates successful lock.
  5. Reconnect USB 3.0 Devices: Once the USR LED remains solid, you may reconnect any previously disconnected USB 3.0 devices.

By performing an initial GPS lock upon startup, the StellarMate Pro establishes a time and location reference point. This allows for continued operation even if the StellarMate App is not actively running.

This procedure is intended for situations where the StellarMate App is not being used for device synchronization. When utilizing the StellarMate App, GPS data is typically acquired from the connected phone or tablet.

Using Active Antenna

By default, SM Pro is shipped with a passive GPS antenna. Due to interference issues from USB 3.0 devices and other sources, the satellite signal may not be sufficient to obtain a GPS lock. StellarMate Pro Active GPS Antenna can be used to overcome this limitation.

SM PRO hardware board revision PRO-3 or later (Release October 2024) provides support for external active GPS antennas. The GPS antenna will not work on older PRO-1 and PRO-2 revision boards. You can find your board hardware revision in the device tab.

Place the antenna at least 50 cm away from SM Pro. In StellarMate App, tap the GPS status indicator to toggle between the Passive & GPS antennas.

gps

View question
Answer

By default, StellarMate Pro does not turn off power to devices after an equipment profile is stopped. Once you toggle on/off a 12V DC output, SM Pro remembers this across sessions. However, it is sometimes desirable to turn off power to connected devices as soon as an Ekos equipment profile is stopped. This might be useful in permentant observatories where StellarMate Pro is always powered. To enable this option, turn on the Power Off option in StellarMate App Power tab.

power_off.webp

View question
Answer

StellarMate Pro uses a high-density XT-60 connector. Included with each unit is an XT-60 to a female DC Jack (5.5x2.5mm) adapter that can support up to 10A.

Please note that using a 5.5x2.1mm adapter might limit the current to only 5A and can cause a voltage drop on the input power side. This might result in unstable output voltage which can distrubt the connect devices.

It is recommended to use the StellarMate Pro Official 10A power supply.

View question
Answer

StellarMate Pro operates on its own dedicated port 12624. If you use StellarMate App to create equipment profiles, then the driver is automatically appended to your equipment profile. Similary, if you try to start an equpiment profile remotely from a PC/Mac, then the Web Manager automatically adds the SM Pro driver to your equipment profile. However, if you create an equipment profile directly in StellarMate Pro (for example, via VNC), then you need to explicitly add the driver in the Remote Driver section:

@localhost:12624

profile_editor.jpeg

View question
Answer

Yes, you can adjust maximum voltage in INDI Control Panel (In App, go to Ekos --> INDI Control Panel --> SM Pro --> Power). By default, it's set to 12.5v so if input voltage is detected above this, it will not allow you to turn on the 12v output. As indicated in the manual, the outputs are indeed unregulated. Therefore, if you adjust this value then adjust it at your own risk. Over voltage can damage some devices.

1. From StellarMate App

max_voltage.webp

2. From INDI Control Panel

over voltage

View question
StellarMate X FAQ

Answer

Need a VESA mount for your StellarMate X or Mele MiniPC running StellarMate X OS? While StellarMate X comes with a VESA mount included, you can now create your own thanks to Steffen Gardner, who designed a 3D-printable version. Download the design and print your mount today!

View question
Answer

StellarMate X creates its own virtual display screen so it is accessible via VNC without any monitors connected. If you connect an external HDMI monitor to StellarMate X, it attempts to clone the internal display to the external display. Sometimes this results in the external display stuck on StellarMate X loading screen. The system is fully usable nonetheless. There are two methods to resolve this:

  1. Unplug and replug the HDMI cable.
  2. Restart StellarMate X, since the issue happens intermittently. 
View question
Answer

No, StellarMate X OS requires a separate license.

View question
Answer

On startup, StellarMate X wil attempt to duplicate the internal virtual display to an external HDMI monitor. You can configure the Display Configuration from StellarMate App or VNC. In VNC, follow the steps highlighted in the picture below to duplicate the VIRTUAL1 output to your external HDMI monitor.

thumb smx hdmi

View question
Ekos Live FAQ

Answer

No, StellarMate is not required. You just need KStars/Ekos to use EkosLive.

View question
Answer

You can access EkosLive from this address https://live.stellarmate.com

View question
Answer

No. Currently, only one connection is permitted to EkosLive. If you try to login from another login, you will be logged out from your current location.

View question
Answer

Absolutely! EkosLive transmits all traffic over SSL and WSL (for Secure Websockets) using industry-proven encryption at both ends. Your data is securely stored where you are the only party that can download and view them. No data is shared with any 3rd party.

View question
Answer

Yes! We offer two tiers of EkosLive subscriptions:

1. EkosLive Basic: Free

2. EkosLive Pro: $4.99/Month subscription.

The EkosLive Pro version differes from Basic in that you get unlimited bandwidth to upload and view images in addition to cloud storage & video streaming capabilities. But the basic version of EkosLive is already quite powerful and can perform Capture, Alignment, Focusing, and Guiding!

View question
Answer

No. EkosLive is a complementary tool to Ekos. It actually requires Ekos in the background. The benefit for EkosLive is that you can access it at any time you have internet access. There is no need to use TeamViewer or 3rd party solutions to login remotely to your PC to check the observatory status. All of this can be done easily and securely with EkosLive. Since it was designed with mobile in mind, you'll find its user interface particullay suited for tablets and phones.

View question
Answer

Ekos Live is a real-time web application that can be run from any browser. It allows you to control many aspects of Ekos right from the browser. It is built around material-ui from Google, so it is very friendly for mobiles & tablets on any platform.

It supports capture, focus, guiding, alignment, and polar assistant tools. Furthermore, it can save your images directly to the cloud where they are stored along with a rich metadata system that enables easy search for images in the future. You can define your own tags to uniquely identifies images of interest.

Turn on sound notificaitons on to get audible alerts on tasks such as when an image is captured and so on. It supports multiple themes (Normal, Dark, and Night) to suit your seeing preferences.

View question
KStars FAQ

Answer

KStars automatically starts up on system boot. To disable automatic startup, toggle it off from EkosLive Dashboard at http://stellarmate.local

ekoslive kstars autostart

Alternatively, you can also disable it from the terminal:

systemctl --user disable --now org.kde.kstars

KStars is required to run StellarMate App. Therefore, if StellarMate App is used, it will launch KStars regardless of startup settings since it is required for the App to operate.

View question
Answer

Q: I changed the language in KStars, but the interface didn’t update. What should I do?
If KStars does not reflect your selected language, try the following steps:

  1. Open a terminal.
  2. Run:

    flatpak config --user --set languages "*"
    flatpak --user --reinstall install org.kde.kstars.Debug
    flatpak --user update
  3. Restart KStars. (usually closing KStars, will autostart it again)

This forces Flatpak to enable all language packs and refresh KStars. After restarting, the selected language should be applied.

KStars can follow your system language, but you can still set a different language manually. The steps above help ensure all translations are available regardless of your OS language.

View question
INDI FAQ

Answer

Starting with SM OS 2.0, KStars and all INDI drivers are installed in a sandbox environment within a flatpak. However, the web manager only lists the System drivers, which are quite limited. To see all drivers, toggle the Driver Source to Flatpak to get a list of all INDI 3rd party drivers.

View question
- Mounts FAQ

Answer

Learn how to configure OnStep Mount Meridian Flip to work with StellarMate. Check the guide for detail.

 

View question
Answer

Thanks to Alan Galitz for submitting this detailed HOWTO.

TLDR: Fixed with mount firmware update to 3.59.45, and using SynScan App to first AutoHome mount, then power cycling before starting StellarMate. See Cloudy Nights discussion and AutoHome/Connection/Power sequence below.

Brief Procedure

  1. Update firmware 150i Mount to 3.59.45 from 3.58 (download from Skywatcher Global site) - best done with USB printer cable
  2. Use SynScan App (latest version from global site), rather than Hand Controller to AutoHome Wave 150I mount
  3. Power OFF Mount
  4. Connect StellarMate and equipment
  5. Ideally connect StellarMate controller to Mount via mount USB (Mount internal USB path works well for this)
  6. Power up StellarMate
  7. Check/enter TIME, LOCATION, EPOCH (JNow likely best)
  8. Verify OTA/mount pointing at Home position set by AutoHome from SynScan APP (RA=0h Dec=90)
  9. Pier Side (Northern Hemisphere) = west pointing east (initial default)
  10. Proceed to alignment

More Details

Firmware Update

StellarMate Initialization Procedure

  1. Power On Wave 150i and let it establish wifi
  2. AutoHome the mount using SynScan App rather than Hand Controller
  3. Verify AutoHome is correct: RA 0, Dec +90
  4. Optional: Clear previous alignment data using SynScan App menu
  5. POWER OFF mount, leaving it in Home Position
  6. Connect and Power On StellarMate (see Power On Sequence below)

Source: Cloudy Nights Forum Discussion

Suggested StellarMate Power On Sequence

  1. 12V Source β†’ ON (feeds to power boxes: PPBADV2 etc)
    Wait 5–8 seconds (LED solid)
  2. Mount (Wave 150i) β†’ ON
    Wait ~10 seconds (electronics ready, USB stable)
  3. USB-only Accessories β†’ ON (cameras, focuser, dew heaters via PPBADV2)
    Do this before 12V & MeLE/PC/etc boots
  4. Dual-power cameras (USB + 12V):
    • Connect USB first (PC sees device)
    • Then connect 12V (cooler/heater gets clean power)
    • Wait ~5 seconds
  5. MeLE PC/StellarMate X/AsiAir etc β†’ ON
    Wait 30–60 seconds (Linux boot complete, devices enumerated)
View question
Answer

For mounts to report their coordinates correctly and in sky with where they are really pointing the sky requires the following conditions to be met:

  1. Accurate time and time zone: This is usually automatically set by the StellarMate App. If not using the App, ensure the time is correct.
  2. Accurate location: This is usually automatically set by the StellarMate App. If not using the App, ensure the location is correct. Please note INDI uses 0 to +360 for longitude. For example, if your longitude is -85 degrees, this would be (-85+360 = 275 degrees) in INDI. Therefore, do not manually change the longitude as it is usually correct.
  3. Starting Position: Mount is powered up in its manufacturer's recommended home or park position.

Depending on whethet the mount is Alt-Az or Equatorial, the starting home position can be different, but in general:

  • Alt-Az: Telescope level with horizon pointing North (Azimuth zero, North Hemisphere) or South (Azimuth 180, Southern Hemisphere).
  • Equatorial: Counter-weights down with telescope pointing directly at the celestial pole.

Some mounts require preliminary alignment and settings via the hand-controller first before they can report any valid positions back to StellarMate. Refer to your mount manual for more details.

After initial connection, slew to mount to a nearby star at least 20-30 degrees away from the celestial pole then plate-solve with StellarMate to synchronize the moutn.

Never Synchronize the mount manually near the celestial poles as this would invalidate the mount's internal pointing.

View question
Answer

While many telescope mounts have a default home position, some, like iOptron models, allow users to set a custom home position. It's important to remember that home and parking positions are distinct concepts, even though they might seem similar. They serve different purposes in mount operation.

Home Position:

  • Reference point: This is usually a position in the sky, such as the north celestial pole or a specific star, that is used as a reference for aligning the telescope and tracking celestial objects.
  • Alignment: It helps to ensure that the telescope is accurately pointed at celestial objects, allowing for precise observations.
  • Tracking: Once aligned, the telescope can track celestial objects as they move across the sky, compensating for Earth's rotation.

Parking Position:

  • Storage: This is a position where the telescope can be safely stored when not in use.
  • Protection: It helps to protect the telescope from weather, dust, and other elements.
  • Convenience: It often makes it easier to set up the telescope for future observations.

setting home position

From StellarMate App, use the Mount Quick Controls (1) to see if you mount support Homing functions (2). If it is supported, slew your mount using the directional control to your intended target and then tap the Home icon and tap Set. This should save the current position as the Home position for your mount.

View question
Answer

Please watch the tutorial given below:

 

View question
- Cameras FAQ

Answer

If supported by the camera, set the Read Mode property to the desired value. A value of 1 indicates High Gain mode.

qhy268.jpeg

View question
Answer

Fast Exposure is an experimental features in all INDI Camera drivers. It enables client (e.g. Ekos) to take multiple exposures in a sequence without awaiting the client to request the next frame.

You can enable Fast Exposure by toggle it in the camera Options tab as shown below. You do not need to set Fast Count as it is handled automatically by Ekos.

Screenshot 20220213 104504

In Ekos or App, take exposure as you normally would. For example, if you add a Job with 5 exposures, without Fast Exposure it works like this:

  1. Ekos asks camera to take 1st exposure.
  2. Camera takes exposure. Once done, driver downloads the image from the camera.
  3. The driver uploads image to Ekos.
  4. After Ekos receives an image, it requests camera to take the 2nd exposure and so forth.

With Fast Exposure enabled, the driver immediately starts the next exposure as soon as the image data is downloaded from the camera.

Therefore, the camera is always busy exposing and downloading data without any wasted time setting as IDLE.

View question
Answer

It's right there! Check under Diffraction Limited manufacturer and you should see the SBIG drivers.

Screenshot 20210428 003900

View question
- Focusers FAQ

Answer

Celestron Focus Motor is supported in StellarMate. It can be connected either directly to the AUX port of the mount, or via USB cable to StellarMate.

If the focuser is connected via USB, then you need to select Celestron SCT focuser driver in your equipment profile in order to control it.

celestron sct focuser profile

Connectiong via AUX is only supported in the Celestron Nexstar/GPS drivers as explained below.

StellarMate provides two different Celestron drivers:

  • Celestron Nexstar/GPS driver: If focuser is connected via AUX port, this driver would automatically recognize the focuser and provides complete control for it.
  • Celestron AUX/Evolution driver: This driver does not support control of the focuser via the AUX port, and therefore the focuser must be connected via USB and controlled via its own dedicated Celestron SCT focuser driver.
View question
- Scheduler FAQ

Answer

Once a sequence is marked as "Completed" in the Ekos Scheduler, it does not revert to "Scheduled" automatically. This behavior is by design, as Ekos is intended to manage imaging over multiple nights. The scheduler checks the capture status of images to determine whether a job is complete.

To restart a completed sequence, you have two options:

Disable Job Progress Tracking:

  • Go to the Scheduler β†’ Job Settings.
  • Turn off "Remember Job Progress".

This allows the scheduler to treat the job as new and re-run it.

Move or Rename Captured Images:

  • Move the previously captured images to a different directory or rename them.

The scheduler will no longer detect the images as completed, and will schedule the job for execution again.

These steps will enable the scheduler to restart the imaging sequence as needed.

View question
- Calibration FAQ

Answer

Yes, you can take dark flats separately from the flats, as long as certain conditions are met:

Match the Exposure Duration:

The dark flats must be taken using the same exposure time as the flats. For example, if your flats were taken at 0.002 seconds, your dark flats should also be taken at 0.002 seconds.

Match the Sensor Temperature:

For best calibration results, ensure that the dark flats are taken at the same sensor temperature as the flats.

While the Ekos Capture Module can auto-generate dark flats during the same session for convenience, it is not a technical requirement. You can manually capture dark flats at a later time β€” just make sure the duration and temperature conditions are replicated accurately.

View question
- Weather Stations FAQ

Answer

If your weather outside is clear and all parameter values are within the expected range, but you're still seeing a yellow or red status code, there's a specific setting you should check: "Flip alerting to in-bounds."


You may have already adjusted the following settings:

  • OK Range Min/Max
  • % for Warning Threshold

However, the "Flip alerting to in-bounds" option controls how the system interprets whether high or low values are desirable for each parameter.

Here’s how it works:

  • Enable "Flip alerting to in-bounds" for parameters where higher values are better (e.g., temperature on a hot day).
  • Disable it for parameters where lower values are better (e.g., cloud cover on a clear day).

Make sure to configure this setting individually for each weather parameter. Once correctly set, your system should report a green status code during favorable weather conditions.

View question
- Observatory Controllers FAQ

Answer

Learn how to use the SVBony SV241 Pro effectively with StellarMate in this HOWTO guide.

View question
Need more help?
Contact us