Installation

This guide shows two easy ways to get started with Soplang:
downloading a prebuilt release or using the official Docker image.

General Download (All Platforms)

Download:
Grab the latest release for your platform from the downloads page.
Extract / Install:
Unzip or install the package as provided by the release.
If it’s a single binary, place it somewhere in your PATH (e.g., ~/bin on UNIX-like systems).
(Optional) Add to PATH:
Ensure the soplang binary is available on your PATH. For example (bash/zsh):
```
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
```
Verify Installation:
Open your terminal and run:
```
soplang --version
```

Create a file named hello.sop with the following content:

file-name.sop

qor("Hello World");

Execute the file by running:
soplang hello.sop

If you already have Docker, you can run Soplang without installing anything else.

Pull the Image:
```
docker pull soplang/soplang:latest
```
Run an Interactive Session:
```
docker run -it --rm soplang/soplang
```
Run a Local File:
Mount your project directory and execute a file:
From your project directory
```
docker run -it --rm -v "$PWD":/app -w /app soplang/soplang soplang hello.sop
```

Verify downloads: Compare the file’s checksum with the one on the downloads page.

Offline: Keep the extracted folder/binary and run directly—no internet required after download.

“command not found”

Make sure soplang is on your PATH, or run it via Docker as shown above.

🔒

Permission denied (UNIX-like)
If you downloaded a binary, grant execute permissions:

chmod +x /path/to/soplang

💬

Still stuck?

Check the downloads page notes or ask in

community support