diff --git a/apple-silicon.md b/apple-silicon.md
new file mode 100644
index 0000000..a8eb36e
--- /dev/null
+++ b/apple-silicon.md
@@ -0,0 +1,31 @@
+# Building MQ container for Apple Silicon (ARM64)
+Build it locally
+```bash
+git clone https://github.com/ibm-messaging/mq-container.git
+cd mq-container
+make build-devserver
+```
+
+Look at the output - specifically the last line.
+```bash
+...
+ => => naming to docker.io/library/ibm-mqadvanced-server-dev:9.3.5.1-arm64 0.0s
+```
+
+Use this image instead of the one from icr.io
+
+~~icr.io/ibm-messaging/mq:9.3.5.1-r1~~
+
+docker.io/library/ibm-mqadvanced-server-dev:9.3.5.1-amd64
+
+Return to [readme.md](readme.md).
+
+## Building a newer/older version
+Edit the version number in `config.env`.
+
+If IBM released a newer versinon, you might also pull down changes from github.
+
+```bash
+cd mq-container
+git pull
+```
\ No newline at end of file
diff --git a/readme.md b/readme.md
index b4c80cf..e1747f8 100644
--- a/readme.md
+++ b/readme.md
@@ -1,6 +1,9 @@
## Creating a MQ container
IBM documentation: https://www.ibm.com/docs/en/ibm-mq/9.3?topic=containers-mq-advanced-developers-container-image
+If you are using Apple Silicon (M1 or newer) you have to build the image yourself - see [apple-silicon.md](apple-silicon.md)
+
+
```bash
# Cleanup previous container
docker stop QM1
@@ -26,14 +29,14 @@ docker run \
icr.io/ibm-messaging/mq:9.3.5.1-r1
# Activate Swagger UI - edit file in the container
-docker exec QM1 /bin/bash
+docker exec -it QM1 /bin/bash
-echo "" > /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
-echo "" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
-echo " " >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
-echo " apiDiscovery-1.0" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
-echo " " >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
-echo "" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo "" > /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo "" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo " " >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo " apiDiscovery-1.0" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo " " >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
+echo "" >> /mnt/mqm/data/web/installations/Installation1/servers/mqweb/mqwebuser.xml
endmqweb && sleep 5 && strmqweb
exit
@@ -63,4 +66,14 @@ icr.io/ibm-messaging/mq:9.3.5.1-r1 # Use a newer version.
```
## Webconsole / Swagger UI
* https://localhost:9443/ibmmq/console/#/
-* https://localhost:9443/ibm/api/explorer
\ No newline at end of file
+* https://localhost:9443/ibm/api/explorer
+
+## Let's play with the API
+- [Display QLOCAL](display-qlocal.md)
+- [Create QLOCAL](create-qlocal.md)
+- [Create QREMOTE](create-qremote.md)
+- [Create QALIAS](create-qalias.md)
+- [Modify Queue](modify-queue.md)
+- [Delete Queue](delete-queue.md)
+- [Create Process](create-process.md)
+- [Messages - put, get, browse, etc.](messages.md)
\ No newline at end of file