Install & Update

Portweaver is distributed as a standalone archive for each supported operating system. Downloads are provided through your Portweaver account.

---

Download Portweaver

1. Sign in at portweaver.com
2. Open account > downloads
3. Confirm the selected operating system
4. Click download

The downloads page automatically selects the operating system used by your browser. You can open the platform menu and select another available build.

Note

If you’re downloading Portweaver from a workstation for a different server, select the server’s operating system instead of the one detected from your browser.

---

Choose the Installation Location

Extract Portweaver into its permanent installation directory before launching it for the first time.

Recommended locations:

Windows

C:\Portweaver\
└── portweaver-server.exe

Linux

~/portweaver/
└── portweaver-server

Portweaver creates its appdata directory beside the executable after first launch.

Caution

Choose the final installation path before starting Portweaver. Application data is encrypted for its current location and must not be moved manually after initialization.

Always use Migration & Recovery when moving an existing installation.

---

Windows Installation

1. Extract the downloaded Windows archive
2. Move portweaver-server.exe into the permanent installation directory
3. Start portweaver-server.exe

Continue with Windows Setup for reverse proxy, firewall, and hosting configuration.

---

Linux Installation

1. Extract the downloaded Linux archive
2. Move portweaver-server into the permanent installation directory
3. Make the binary executable:

chmod +x portweaver-server

4. Start Portweaver:

./portweaver-server

Continue with Linux Setup for dependencies, reverse proxy, firewall, and service configuration.

---

First Access

After Portweaver starts, complete Post-Install Setup.

The default installation listens on:

http://localhost:8080

The first login must be completed locally using the default admin account.

---

Automatic Updates

Automatic updates are an easy way to keep Portweaver up-to-date from within the app. Updates won’t execute automatically, however, the whole process is automated. To use this feature, you’ll need:

• An active Portweaver license
• An activated local Portweaver installation
• Connectivity to portweaver.com

Portweaver checks for updates automatically. To view the current status:

1. Open the user menu
2. Open settings > general and scroll down to “Updates”

Release Channels

stable

• Recommended for production
• Receives normal Portweaver releases

beta

• Receives development builds
• Intended for testing before a stable release

Changing the release channel will immediately check for a newer build.

---

Install an Automatic Update

When an update is available:

1. Click the update button
2. Review the version & restart notice
3. Click install on the popup

Tip

Create a backup before installing an update.

Portweaver will:

• Download the selected release
• Verify its size and SHA-256 checksum
• Replace the current executable
• Restart automatically

The web interface will disconnect briefly while the server restarts.

---

Manual or Offline Updates

Use a manual update when:

• The Portweaver server cannot reach portweaver.com
• The installation is not licensed
• The server is managed by an external service
• The automatic update fails

To update manually:

1. Create a backup
2. Download the latest stable archive from account > downloads
3. Transfer the archive to the Portweaver server
4. Stop Portweaver
5. Extract the new executable
6. Replace the existing executable in place
7. On Linux, run:

chmod +x portweaver-server

8. Start Portweaver again

Caution

Replace only the executable. Do not delete, overwrite, or move the appdata directory.

Note

When Portweaver is supervised by systemd or another service manager, stop the service before replacing the executable and start it again afterward.