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`

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/

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


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

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.

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

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:

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.

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

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.

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.

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

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.

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

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

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

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

 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.

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). 

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.

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.

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.

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 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:

• 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.