Quick Start

10/15/24Less than 1 minute

Quick Start

Warning

It is strongly recommended to fully test in a staging environment before deploying to production. Please report any issues promptly.

1. Download the latest version v1.3.21

Gitee: https://gitee.com/samwaf/SamWaf/releases

GitHub: https://github.com/samwafgo/SamWaf/releases

2. Quick Start

Linux

install

curl -sSO https://update.samwaf.com/latest/install_samwaf.sh && bash install_samwaf.sh install

uninstall

curl -sSO https://update.samwaf.com/latest/install_samwaf.sh && bash install_samwaf.sh uninstall

Windows

Direct start:

SamWaf64.exe

As a service As Administration

//Install & Start
SamWaf64.exe install && SamWaf64.exe start

//Stop &  Uninstall 
SamWaf64.exe stop && SamWaf64.exe uninstall

PS: Note that starting from version v1.3.7-beta.1, if your system is Windows Server 2008 R2, please download SamWaf64ForWin7Win8Win2008.exe to use.

Linux Arm64

For Linux Arm64 architecture, please download the corresponding file SamWaf_Linux_arm64.v*.tar.gz

./SamWafLinuxArm64 install && ./SamWafLinuxArm64 start

Docker

For Docker, please pull the latest version from Docker Hub (https://hub.docker.com/r/samwaf/samwaf)

docker run -d --name=samwaf-instance \
           --restart always \
           -p 26666:26666 \
           -p 80:80 \
           -p 443:443 \
           -v /path/to/your/conf:/app/conf \
           -v /path/to/your/data:/app/data \
           -v /path/to/your/logs:/app/logs \
           -v /path/to/your/ssl:/app/ssl \
           samwaf/samwaf

3. Start and Access

http://127.0.0.1:26666

Default username: admin
Default password: admin868
(Note: Please change the default password upon first login)

About the initial password

Since v1.3.21-beta.8 no longer use a fixed default password for a fresh install — they generate a random initial password written to data/initial_password.txt in the program directory (the startup log also shows a hint). If admin868 does not work, open that file to get the initial password. Either way, change the password immediately after first login.