PolySwarmPolySwarmPolySwarmPolySwarm
Help

Linux Configuration

System Requirements

Make sure your system meets or exceeds the following requirements:

  • x86-64 CPU
  • 8GB of RAM

These instructions are developed against and tested to work on Xubuntu 18.04 amd64.


Install Prerequisites & Configure Development Environment

Install Docker

We've Docker-ized as many things as possible to make it easy to dive right in.

You need to install Docker-CE (base) as well as Docker Compose. If you do not have a recent Docker setup, please install Docker now.

Once installed, verify that the installation works by running

$ docker ps

Should output:

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

Next, install docker-compose.

Once it is installed, verify the installation works by running:

$ docker-compose -v

Should output at least: docker-compose version 1.21.1, build 5a3f1a3

After installing Docker, we recommend adding your user to the docker group so that you can easily issue docker commands without sudo:

$ sudo usermod -aG docker ${USER}

You'll need to reboot in order for the change to take effect.

Install Git

We'll need to grab a few source code repositories; it'll be easiest to use Git. Please install Git for your development environment.

Install Python & PIP

PolySwarm development requires Python 3.6.5 or above. Please install Python and PIP for your development platform.

Set up a Virtual Environment (virtualenv)

We recommend that you create a PolySwarm virtualenv to keep the system-wide Python packages clean:

python3 -m venv polyswarmvenv
source polyswarmvenv/bin/activate

Install polyswarm-client Libraries

If you're using a virtualenv (see above), ensure that you activate it before installing polyswarm-client.

Compiling & installing polyswarm-client libraries is simple.

First, install Python 3 headers / build requirements.

On Ubuntu, this is achieved with:

$ sudo apt install python3-dev

Next, install libssl-dev

$ sudo apt install libssl-dev

Finally:

pip install polyswarm-client

Verify Installation

You should now have a working development environment!

To verify, simply try importing polyswarmclient:

$ python
...
>>> import polyswarmclient
>>>

You should be able to import polyswarmclient without issue.

Next Steps

Now that we have a working development environment, we'll use participant-template to bootstrap our project.

Create Your Participant →