Skip to main content


Smocker can be installed either with Docker or manually on any Linux system, depending on your needs.

With Docker

docker run -d \
--restart=always \
-p 8080:8080 \
-p 8081:8081 \
--name smocker \

or with TLS enabled:

docker run -d \
--restart=always \
-p 44300:8080 \
-p 44301:8081 \
-v /path/to/your/cert.pem:/etc/smocker/tls/certs/cert.pem:ro \
-v /path/to/your/key.pem:/etc/smocker/tls/private/key.pem:ro \
--name smocker \

Manual Deployment


The official binaries are currently built for Linux only. This is not a hard limit though, as the source code should be fully compatible with most of the standard platforms.

# This will be the deployment folder for the Smocker instance
mkdir -p /opt/smocker && cd /opt/smocker
wget -P /tmp
tar xf /tmp/smocker.tar.gz
rm /tmp/smocker.tar.gz

nohup ./smocker -mock-server-listen-port=8080 -config-listen-port=8081 &

# Or with TLS

# The certificate is expected in /etc/smocker/tls/certs/ by default
# You can override it with -tls-cert-file and -tls-private-key-file
nohup ./smocker -mock-server-listen-port=44300 -config-listen-port=44301 -tls-enable &


To check that Smocker started successfully, just run the following command:

curl localhost:8081/version

or with TLS enabled:

curl https://localhost:44301/version

# Or if you use a self signed certificate
curl -k https://localhost:44301/version