Bartender# DOI Research Software Directory Badge Documentation Status

Bartender is a middleware web service to schedule jobs on various infrastructures.

It can run command line applications for visitors. The application input should be a configuration file with links to data files in the same directory. After acquiring a JWT token, you can upload your configuration file and data files as an archive to the web service for submission. Once the job has been executed the output files can be browsed with a web browser.

Bartender can be configured to run applications on a Slurm batch scheduler, pilot job framework, the grid or in the cloud. Bartender will take care of moving the input and output files to the right place. To pick where an application should be run you can choose from a list of existing Python functions or supply your own.

Bartender can run quick interactive applications on completed jobs. This is handy if you want to run a quick analysis on the output of a job.

Bartender can be used as the computational backend for a web application, the web application should guide visitors into the submission and show the results. See for an example.

Documentation for users and developers is available at .


  1. Install bartender via github:

    pip install git+
  2. Obtain a copy of the example configuration file

    curl -o config.yaml
  3. In another terminal, start up a database for storing jobs.

    docker run \
        -p "5432:5432" \
        -e "POSTGRES_PASSWORD=bartender" \
        -e "POSTGRES_USER=bartender" \
        -e "POSTGRES_DB=bartender" \
        --mount type=volume,source=bartender-db,target=/var/lib/postgresql/data \

    (Use docker volume rm bartender-db to clear the database storage`)

  4. Create tables in the database

    alembic upgrade "head"
  5. Generate token to authenticate yourself

    # Generate a rsa key pair
    openssl genpkey -algorithm RSA -out private_key.pem \
        -pkeyopt rsa_keygen_bits:2048
    openssl rsa -pubout -in private_key.pem -out public_key.pem
    bartender generate-token --username myname
  6. Run the application

    bartender serve
  7. Go to the interactive API documentation generated by FastAPI


Consuming web service#

The interactive API documentation generated by FastAPI is at http://localhost:8000/api/docs


To consume the bartender web service you need to authenticate yourself with a JWT token in the

  • HTTP header Authorization: Bearer <token> or

  • query parameter ?token=<token> or

  • Cookie bartenderToken=<token>of the HTTP request.

For more info see Configuration docs

Word count example#

Bartender is by default configured with a word count applicaton. Use the following steps to run a job:

  1. Create an archive to submit. The zip file should contain a file called A zip file could be created in a clone of this repo with zip

  2. Start bartender web service and postgresql server

  3. Generate token & authorize

    1. Run bartender generate-token and copy output to clipboard. (Make sure to not to have any newlines in the token)

    2. Goto and

    3. Open authorize dialog by pressing authorize button on top of page

      1. Paste token from clipboard in any Value input text box

      2. Press Authorize button and close button.

    4. Try out the GET /api/whoami route. It should return JSON document with someone as username.

  4. Submit archive.

    1. Try out the PUT /api/application/wc/job route.

    2. Upload the as request body.

    3. Press execute button

    4. The response contains a job identifier (id property) that can be used to fetch the job state.

  5. Fetch job state

    1. Try out the GET /api/job/{jobid}

    2. Use job identifier retrieved by submit request as jobid parameter value.

      • When job state is equal to ok the job was completed succesfully.

  6. Retrieve result. The word count application (wc) outputs to the stdout.

    1. Try out the GET /api/job/{jobid}/stdout

    2. Use job identifier retrieved by submit request as jobid parameter value.

    3. Should see something like 433  1793 14560 Where numbers are counts for newlines, words, bytes.