SetFN
SetFNDocsOctober 27, 2026

Troubleshooting Guide

Problems can arise while installing or using SetFN. This document organizes causes and solutions by commonly reported symptom. Please find the symptom you're experiencing in the list below.

Installation

Q: Does a port conflict error occur during installation?

This happens when another program is already using a port that SetFN needs.

  1. Check which program is using that port
  2. Either stop the conflicting program, or change SetFN's port setting
  3. Run the installation again

Q: Installation completed, but the service doesn't start?

If you set up auto-start (systemd), check the service status and logs.

  1. Check the running status with systemctl status setfn-spacebuilder
  2. If it is stopped, start it with sudo systemctl start setfn-spacebuilder
  3. If it still does not start, check the error messages with journalctl -u setfn-spacebuilder -n 100 --no-pager
  4. Check that the User and ExecStart values in the service file match the actual username and executable path

If you have not set up auto-start, run the executable again in a terminal. For details, see Installing on Linux.

Q: Can I install with Docker?

The official Docker image is not yet available. Do not run docker pull or docker run with an arbitrary image name.

  1. For now, install by following Installing on Linux
  2. Check the status of Docker support in Installing with Docker

Connectivity

Q: Can't access SetFN from the browser?

There may be an issue with network settings or service status.

  1. Check that the SetFN service is running normally
  2. Check that the access address (IP, port) is correct
  3. Check that the port is allowed through the firewall
  4. Try connecting from another device on the same network

Q: Can't log in?

  1. Check that your ID and password are correct
  2. Check that Caps Lock is not on
  3. If you've forgotten your password, use the password reset feature
  4. Your account may have been disabled by an administrator — contact your administrator

Q: Can't connect from outside the network?

You'll need to verify that the external access settings are configured correctly.

  1. First check that you can connect with the internal network address from the same network
  2. Check that the external access connection, such as Cloudflare Tunnel, is running
  3. Check that the domain is connected correctly
  4. Check Active Blocks List under Block Management to make sure the IP you are connecting from is not blocked

Q: Only a specific user can't connect?

  1. Repeated login failures can block the IP automatically. Check that user's IP in Active Blocks List under Block Management
  2. Check that the user account's permissions and status are normal

Q: The administrator can't log in either?

If even the administrator account is blocked, or you cannot enter the admin page because the password is unknown, recover access with commands in a terminal on the computer where SpaceBuilder is installed.

  1. Lift a login block with the unblock command
  2. Change the administrator password with the user password command
  3. If the IP access restriction keeps you from accessing the admin page, fix the allowed list with the ip command

For details, see Managing the Server with Commands.

Files

Q: File upload fails?

  1. Check that you have write permission on the target upload folder
  2. Check the server's remaining disk space
  3. Check that the file size does not exceed the configured limit
  4. Check that the network connection is stable

Q: File download speed is slow?

  1. Check that the server and client are on the same internal network
  2. Check that network bandwidth is sufficient
  3. Check that the server's CPU and memory usage are not excessively high
  4. If there are many concurrent users, consider upgrading server specs

Q: A file doesn't appear in the list?

  1. Check that the current user's level and team have access to that folder
  2. Check whether a folder filter is applied that is hiding the file
  3. Clear your browser cache and refresh

Performance

Q: Has SetFN's overall performance slowed down?

Server resources may be insufficient.

  1. Check the server's CPU and memory usage
  2. Check that there is enough disk capacity (performance can degrade when free space is under 10%)
  3. Check in System Management > Background Services that AI, indexing, and other jobs are not consuming excessive resources
  4. Try restarting the server

Q: Is search slow, or not returning results?

  1. Check that the search index has been built correctly
  2. If there is a very large number of files, try narrowing the search to a specific folder
  3. After a server restart, it may take some time before the index is rebuilt

Other

Q: Are there browser compatibility issues?

SetFN recommends using a modern web browser. Please check the following.

  1. Check that you're using the latest version of Chrome, Edge, Firefox, or Safari
  2. Internet Explorer is not supported — please use a different browser
  3. Clear your browser cache and cookies, then try again

Q: None of the above resolved the issue?

  1. Check the error messages in the server log. If SetFN runs with auto-start, use journalctl -u setfn-spacebuilder -n 100 --no-pager
  2. Check the operating system and disk status in System Management > Device Information
  3. Contact SetFN's official technical support team, including the error message and environment details