To run a database that can be used by the Ampersand prototype framework, you can easily use a Docker image from: docker.pkg.github.com/ampersandtarski/prototype-db/prototype-db

To run the Ampersand compiler from any computer that runs docker, use a Docker image from our Ampersand repository on GitHub: docker.pkg.github.com/ampersandtarski/ampersand/ampersand

Make a shortcut tag to save typing:

docker tag docker.pkg.github.com/ampersandtarski/ampersand/ampersand ampersand

Different tags are available, e.g.:

• :latest -> development branch It contains the most recent developments that have passed the automated test sets.

• :stable -> master branche This contains the latest stable release of ampersand. Use it for the lowest risk.

• :[branch] -> specific branch This allows you to pick a version yourself

• :v3.17 -> specific tags/releases To use a specific previous version.

This alternative presumes you have docker installed on your computer and it can be found (i.e. the path is set correctly).

If you experience problems downloading from docker.pkg.github.com, you may first have to log in with an appropriate token. Generate a token and be sure to switch on all repo-rights and the read:packages-right. With that token log in:

Different aspects of the Ampersand user's environment can be containerized 1. Ampersand compiler 1. Modelling environment for Ampersand user (incl. VSCode extensions) 1. Prototype environment, including:

• Apache webserver with PHP

• Ampersand compiler

• PHP-composer

• NPM (Node Package Manager)

• Gulp

  1. Multi-stage prototype build, only:

• Apache webserver with PHP

• Generated code

  1. Prototype database

• MariaDB with default user/password

A docker-compose file is available to deploy prototype, database and supporting tools (like phpMyAdmin)

Deploy your local environment to run Ampersand prototypes

Detailed technical instructions are at under the directory listing. This page provides more general and summarized information as context.

The contains a docker-compose and Dockerfile to generate, build and run a prototype application.

Run: docker-compose up -d to deploy the following services:

• Apache webserver

  • Serves your prototypes

  • Available in the browser at http://localhost:80

Install instructions for Windows

• Install Docker from and start the desktop app

• Go to

• Click on the green “Code” button and pull down to “Download ZIP”

RAP's GitHub site has more technical install instructions at

Prerequisites:

1. Make sure that ports 80 and 443 on your laptop are available. (In other words: if you run a web server on your laptop, bring it down.)

2. Make sure that docker is running on your laptop.

Here is what to do:

1. git clone into an empty directory, so you have all the necessary files needed to deploy your application. We will call this the working directory.

2. Substitute the file "MyScript.adl" in the working directory for the Ampersand script you want to run.

3. Edit the file .env to choose a root password for the database and an ampersand password for your application that accesses this database. Please choose safer passwords than the ones shown, which are merely examples. DON't publish the

Now you are set to go and tinker with your application.

Things that can go wrong

to be done