Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
128 lines (91 sloc) 3.47 KB

gg Build Status

Research Paper

"From Laptop to Lambda: Outsourcing Everyday Jobs to Thousands of Transient Functional Containers," in 2019 USENIX Annual Technical Conference (USENIX ATC '19).


Building FFmpeg with gg on AWS Lambda


Tech Video

gg was presented at 2019 USENIX Annual Technical Conference (USENIX ATC '19). The talk was given on July 11, 2019.

Alt text

Build directions

Notice: If you are Docker adept, follow this instruction.

To build gg you need the following packages:

  • gcc >= 7.0
  • protobuf-compiler, libprotobuf-dev >= 3.0
  • libcrypto++-dev >= 5.6.3
  • python3
  • libcap-dev
  • libncurses5-dev
  • libboost-dev
  • libssl-dev
  • autopoint
  • help2man
  • texinfo
  • automake
  • libtool
  • pkg-config
  • libhiredis-dev
  • python3-boto3

You can install this dependencies in Ubuntu (17.04 or newer) by running:

sudo apt-get install gcc-7 g++-7 protobuf-compiler libprotobuf-dev \
                     libcrypto++-dev libcap-dev \
                     libncurses5-dev libboost-dev libssl-dev autopoint help2man \
                     libhiredis-dev texinfo automake libtool pkg-config python3-boto3

To build gg, run the following commands:

make -j$(nproc)
sudo make install


Environment Variables

To use gg, the following environment variables must be set:

  • GG_MODELPATH => absolute path to <gg-source-dir>/src/models/wrappers.
    • S3: s3://<bucket-name>/?region=<bucket-region>
    • Redis: redis://<username>:<password>@<host>[:<port>]
  • GG_LAMBDA_ROLE => the role that will be assigned to the executed Lambda. functions. Must have AmazonS3FullAccess and AWSLambdaBasicExecutionRole permissions.
  • AWS_REGION => your AWS region, where the functions are installed

Installing the Functions

After setting the environment variables, you need to install gg functions on AWS Lambda. To do so:

cd src/remote/
make ggfunctions


To build mosh using gg, first we checkout the mosh source code:

git clone

Make sure that you have all the dependencies for building mosh. In Ubuntu, you can run:

sudo apt-get install -y automake libtool g++ protobuf-compiler libprotobuf-dev \
                        libboost-dev libutempter-dev libncurses5-dev \
                        zlib1g-dev libio-pty-perl libssl-dev pkg-config

Inside the mosh directory, first you need to prepare mosh to build:



gg init # creates .gg directory
gg infer make -j$(nproc) # creates the thunks

Now, to actually compile mosh-server on AWS Lambda with 100-way parallelism, you can execute (it's important that --jobs comes before --engine):

gg force --jobs 100 --engine lambda src/frontend/mosh-server
You can’t perform that action at this time.