Skip to main content
This guide walks you through launching WebPublish, creating a task to serve a local folder, accessing the served URL, and stopping the task when you are done.

​
Publish your first folder

1

Launch WebPublish

Open WebPublish from your Start menu (Windows), application menu (Linux), or by running the AppImage.The main window opens and the application icon appears in the system tray. WebPublish is ready to serve on port 9090 by default.
You can change the port at any time in Settings. See Server configuration for details.
2

Create a new task

Click the Add (or +) button in the toolbar to open the new task dialog.Fill in the task details:
FieldWhat to enter
TypeSelect Directory
PathClick Browse and select the local folder you want to serve
NameEnter a descriptive label, for example my-site
Click OK (or Confirm) to save the task.
WebPublish assigns each task a unique path segment (ID). Your folder will be accessible at http://127.0.0.1:9090/<task-id>.
3

Start the task

The new task appears in the task list with a stopped status.Click the Start toggle or button next to the task to enable it. The status indicator turns green when the task is running.
4

Access the served URL

Click the URL displayed next to the task, or copy it and paste it into any browser.
http://127.0.0.1:9090/<task-id>
You will see a directory listing of your folder. Clicking any file downloads or displays it in the browser.
To share the content with other devices on your local network, change the address binding from 127.0.0.1 to your machine’s LAN IP address in Settings. See Server configuration.
5

Stop the task

When you no longer need to serve the folder, click the Stop toggle next to the task.The task remains saved in the list and can be restarted at any time. To remove it permanently, click the Delete (trash) icon.

​
Task types

WebPublish supports five types of publishing tasks. Choose the one that fits your use case:

Directory

Serve an entire folder as a browsable static file tree

File

Share a single file over HTTP

MBTiles

Host a map tile dataset with raster and vector tile support

Proxy

Forward local requests to a remote URL

​
Next steps

All task types

Explore directory, file, MBTiles, proxy, and CLT tasks in depth

Configuration

Adjust the default port, address, gzip, and startup behavior

Build docs developers (and LLMs) love

Get started for freeTalk to us