SetFN
SetFNDocs2026년 9월 18일

Installing on Windows

A native Windows installer for SetFN SpaceBuilder is currently being prepared. Until it's released, you can use WSL (Windows Subsystem for Linux), built into Windows, to install and run SpaceBuilder in a Linux environment. This guide covers setting up WSL and installing SpaceBuilder inside it.

Before you begin

  • Windows 10 (version 2004 or later) or Windows 11
  • An account that can run PowerShell as administrator
  • Sufficient disk space to store service data and files you'll upload in the future

Installing WSL and Ubuntu

If WSL is already installed, skip this section and go to Installing SpaceBuilder.

  1. Run PowerShell as administrator.
  2. Enter the following command.
    wsl --install

    This installs WSL2 along with Ubuntu, its default distribution.
  3. Once installation finishes, restart your computer.
  4. After restarting, an Ubuntu terminal opens automatically. Enter a username and password to create your Ubuntu account.

Installing SpaceBuilder

The Ubuntu environment inside WSL behaves the same as a regular Linux environment. Open the Ubuntu terminal and follow Installing on Linux from downloading the installer through the first run.

Accessing it from a Windows browser

WSL2 shares its network with Windows, so even while SpaceBuilder is running inside Ubuntu, you can open it directly from a Windows browser like Chrome or Edge at http://localhost:18510. If a different port is used, use the address printed in the Ubuntu terminal.

When the initial setup page opens, review and agree to the terms of service, then go to Initial Setup to configure the administrator account and service environment.

Good to know

  • Closing the Ubuntu terminal also stops SpaceBuilder. To keep it running after closing the terminal, follow Starting automatically when the computer turns on to set up systemd auto-start. Using systemd in WSL first requires setting systemd=true under [boot] in /etc/wsl.conf.
  • Shutting down or restarting Windows also shuts down WSL. Even with systemd auto-start configured, Windows doesn't automatically restart WSL on its own — after a restart, you need to open the Ubuntu terminal yourself for SpaceBuilder to start again.
  • To access SpaceBuilder from another device on the same network, you'll also need to check WSL's network settings and your Windows firewall rules.

Starting WSL automatically after a Windows restart

You can register a Task Scheduler task that launches WSL at logon, so SpaceBuilder starts again after a restart without opening the Ubuntu terminal yourself. This requires systemd auto-start to already be configured.

  1. Open Task Scheduler by running taskschd.msc.
  2. Select Create Task (not Create Basic Task, which doesn't expose all the options you need).
  3. On the Triggers tab, select New, set Begin the task to At log on, and choose the user account you use.
  4. On the Actions tab, select New, set Program/script to wsl.exe, and enter the following in Add arguments.
-d Ubuntu -u <username> -- true

Replace <username> with the username you set up for your Ubuntu account. This command only boots WSL and starts systemd; the SpaceBuilder service you already enabled then starts automatically.