Download LatestGet StartedReferenceForumsContribute

Installing Soplang

This guide will walk you through the process of installing Soplang on your system. Soplang is available for Windows, macOS, and Linux.

Prerequisites

Before installing Soplang, ensure your system meets the following requirements:

  • Windows 10 or later, macOS 10.15+, or a modern Linux distribution
  • 4GB RAM (minimum)
  • 500MB of free disk space
  • Internet connection for package installation

Windows Installation

Using the Installer (Recommended)

  1. Download the latest Windows installer (.msi file) from the downloads page.
  2. Run the installer by double-clicking the downloaded file.
  3. Follow the installation wizard instructions. We recommend keeping all default options.
  4. The installer will automatically add Soplang to your PATH environment variable.
  5. To verify the installation, open Command Prompt or PowerShell and run:
    soplang --version

Using Chocolatey

If you use Chocolatey package manager, you can install Soplang with the following command:

choco install soplang

macOS Installation

Using the Installer Package

  1. Download the latest macOS installer (.pkg file) from the downloads page.
  2. Open the downloaded .pkg file.
  3. Follow the installation wizard instructions.
  4. To verify the installation, open Terminal and run:
    soplang --version

Using Homebrew

If you use Homebrew package manager, you can install Soplang with the following command:

brew install soplang

Linux Installation

Debian/Ubuntu

sudo apt-get update sudo apt-get install soplang

Fedora

sudo dnf install soplang

Arch Linux

sudo pacman -S soplang

Using the Tarball

  1. Download the latest Linux tarball (.tar.gz file) from the downloads page.
  2. Extract the tarball:
    tar -xzf soplang-1.2.0-linux-x86_64.tar.gz
  3. Navigate to the extracted directory:
    cd soplang-1.2.0
  4. Run the installation script:
    ./configure make sudo make install
  5. To verify the installation, run:
    soplang --version

Using Docker

Soplang is also available as a Docker image. You can pull the latest image with:

docker pull soplang/soplang:latest

To run Soplang in a Docker container:

docker run -it --rm soplang/soplang

Virtual Environments

It's recommended to use virtual environments for Soplang projects to manage dependencies and isolate your project environment.

Creating a Virtual Environment

soplang -m venv myenv

Activating the Virtual Environment

On Windows:

myenv\Scripts\activate

On macOS and Linux:

source myenv/bin/activate

Troubleshooting

Common Issues

Command not found error

If you get a "command not found" error when trying to run Soplang, ensure that the installation directory is in your PATH environment variable.

Permission denied error

On Linux and macOS, you might need to add execute permissions to the Soplang binary:

chmod +x /path/to/soplang

Dependency issues

If you encounter dependency issues, try reinstalling Soplang or check the community forums for help.

Next Steps

Now that you have Soplang installed, you can start learning the basics and writing your first program:

Quick Start

Write your first Soplang program and learn the basics.

Syntax Basics

Learn the fundamental syntax of Soplang.

Previous: IntroductionNext: Quick Start