Skip to content

FAQ & Troubleshooting

JT edited this page Nov 10, 2024 · 4 revisions

FAQ

1. Can I move Stability Matrix to another drive or computer?

  • Yes, the Data Directory in both Portable mode and selected directory mode is able to be moved to another computer.
    • In portable mode, simply move the "Data" folder along with the app (keeping them in the same destination directory).
    • In selected directory mode, move the app and the Data Directory separately. When you start the app for the first time after moving, it will prompt you to select a Data Directory again - select the destination where you moved the new Data Directory and it will be recognized.

The Data Directory holds platform-specific assets and should not be moved to another Operating System type (i.e. Windows -> Linux)

2. Can I import an existing local Package to Stability Matrix?

  • Yes, if you have a standard install of our supported packages (main package folder should contain a "venv") you can move the package folder under (Data)/Packages where (Data) is your selected Data folder. After that navigate to the Package page and it should show as an "Unknown Package"

ℹ️ Note - The import will move existing model files into the shared model folder in (Data)/Models, it may take a few minutes depending on disk speed. If there are conflicts with existing files the import may fail, if this is the case please remove existing model files before importing then manually move to the shared folder as required.

image

Next, follow the prompt to select the type and version of the package. If you're not sure about the version, you can select the latest.

image

Troubleshooting

1. The app starts but is not visible / appears to be off-screen

We've added more checks from v2.1.0 onwards, but this sometimes happened in multi-monitor setups when the last saved window position is out of bounds.

To fix this start the app once with the launch argument --reset-window-position

2. Stability Matrix keeps overwriting my changes to ComfyUI's extra_model_paths.yaml file!

When Model Sharing is set to "Config" for ComfyUI, we always update the stability_matrix section with links to our model folders. If you want to add your own, you'll need to add your extra paths outside of the stability_matrix section. For example, a new category named foobar:

foobar:
  checkpoints: C:\My\path\to\checkpoints
  ... etc ...
stability_matrix:
  checkpoints: G:\SMData\Data\Data\Models\StableDiffusion
  vae: G:\SMData\Data\Data\Models\VAE
  loras: >-
    G:\SMData\Data\Data\Models\Lora

    G:\SMData\Data\Data\Models\LyCORIS
  upscale_models: >-
    G:\SMData\Data\Data\Models\ESRGAN

    G:\SMData\Data\Data\Models\RealESRGAN

    G:\SMData\Data\Data\Models\SwinIR
  embeddings: G:\SMData\Data\Data\Models\TextualInversion
... etc ...

Please check the ComfyUI example file for more details.