Simple Web ServerSimple Web Server
Download
Documentation
  • English
  • 简体中文
  • 繁體中文
  • Español
  • Français
  • Português
  • Русский
  • Deutsch
  • 日本
  • 한국어
  • Italiano
  • Українська
  • Azərbaycanca
  • Nederlands
  • Svenska
GitHub
Download
Documentation
  • English
  • 简体中文
  • 繁體中文
  • Español
  • Français
  • Português
  • Русский
  • Deutsch
  • 日本
  • 한국어
  • Italiano
  • Українська
  • Azərbaycanca
  • Nederlands
  • Svenska
GitHub
    • Server Options
    • App Settings
    • Editing config.json
    • Using HTTPS
    • Viewing logs
    • Building from source
    • Coming from Web Server for Chrome?
    • Introduction to plugins
    • Plugin manifest file
    • Plugin script
    • Advanced configuration using .swshtaccess files
    • Using custom scripts
    • Creating a custom request handler

Editing config.json

All server options and app settings are stored in one file, config.json. It's possible to manually edit this file to access options that aren't accessible from the user interface.

Options are stored in JSON format. You can find the name (key) and type of value for each option on the Server Options and App Settings pages.

Changes made to this file while the program is running will take effect immediately. Changes will reload the app's user interface, which may cause you to lose unsaved changes.

Warning

If you download the app from the Mac App Store, your web server may stop working if you change the path option directly from config.json. This is because the app only has permission to read from directories that have been selected using the open dialog in the app. To avoid this problem, only change the path from within the app.

Here's where to find the config.json file:

Windows: C:\Users\[USERNAME]\AppData\Roaming\Simple Web Server\config.json

macOS (Direct download): /Users/[USERNAME]/Library/Application Support/Simple Web Server/config.json

macOS (App Store): /Users/[USERNAME]/Library/Containers/org.simplewebserver.simplewebserver/Data/Library/Application Support/Simple Web Server/config.json

Linux: TODO

Here's what the config file might look like:

{
  "servers": [
    {
      "enabled": true,
      "path": "/Users/username/Documents/GitHub/website",
      "localnetwork": false,
      "index": true,
      "port": 8080,
      "cors": false,
      "showIndex": true,
      "spa": false,
      "rewriteTo": "/index.html",
      "directoryListing": true,
      "excludeDotHtml": false,
      "ipv6": false,
      "cacheControl": "",
      "hiddenDotFiles": false,
      "upload": false,
      "replace": false,
      "delete": false,
      "staticDirectoryListing": false,
      "hiddenDotFilesDirectoryListing": true,
      "htaccess": false,
      "custom404": "",
      "custom403": "",
      "custom401": "",
      "customErrorReplaceString": "",
      "https": false,
      "httpsCert": "",
      "httpsKey": "",
      "httpAuth": false,
      "httpAuthUsername": "",
      "httpAuthPassword": "",
      "ipThrottling": 10
    }
  ],
  "background": true,
  "updates": true,
  "theme": "system"
}
Edit this page on GitHub
Next
Using HTTPS