Version 7 (modified by welberge, 6 years ago) (diff)



SoaScript makes projectmanagment (cloning, building, pulling/pushing, intra-project dependency handling) within Asap and other projects using HmiBuild easier on Mac and Linux systems. To be able to use SoaScript, one requires a techfak login and access to /vol/soa (locally or via portb or porta).


Download this file and preferably place it somewhere in your PATH:


Run soa init in your terminal and follow the instructions. You are guided through a system-dependent setup process.

Optional: ssh key setup

You can use ssh keys to make your login easier (that is: requiring you to enter fewer or no passwords). To create a public/private key pair run


This creates a private key and a public key in the .ssh dir of your home directory. You then need to append the public key to the authorized_keys file in the .ssh dir of the home directory of the server (

cat >> ~/.ssh/authorized_keys

Make sure that the authorized_keys file is only accessible to the owner

chmod 600 ~/.ssh/authorized_keys

You should now be able to login (e.g. ssh without password, or using pass phrase you've set for your keys when creating them with ssh-keygen. If this fails, use ssh -v to troubleshoot. You can use multiple v-s (e.g. ssh -vv) to get more debug information.


Call soa help to get a list of supported commands.

Here are the most common ones:

  • soa list lists remotely avaiable packages.
  • soa clone clones a package to your local storage
  • soa clone-all clones a package and its dependencies
  • soa build inside a package directory builds the project.
  • soa build-all builds dependencies, too
  • soa create billieproject myBillie creates a new project "myBillie" from the template "billieproject" (find templates using soa list)