@flowfuse/driver-docker 1.14.0

package/.eslintrc

@@ -0,0 +1,19 @@
+{
+    "root": true,
+    "env": {
+        "browser": true,
+        "commonjs": true,
+        "es2021": true,
+        "mocha": true
+    },
+    "extends": [
+        "standard"
+    ],
+    "parserOptions": {
+        "ecmaVersion": 12
+    },
+    "rules": {
+        "indent": ["error", 4],
+        "object-shorthand": ["error"]
+    }
+}

package/.github/workflows/build.yml

@@ -0,0 +1,24 @@
+name: Default Build & Test
+
+on:
+    push:
+        branches: [main]
+    pull_request:
+        branches: [main]
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                node-version: [16.x]
+        steps:
+            - uses: actions/checkout@v3
+            - name: Use Node.js ${{ matrix.node-version }}
+              uses: actions/setup-node@v3
+              with:
+                  node-version: ${{ matrix.node-version }}
+            - name: Install Dependencies
+              run: npm ci
+            - name: Run lint
+              run: npm run lint

package/.github/workflows/project-automation.yml

@@ -0,0 +1,10 @@
+name: Project automations
+on:
+  issues:
+    types:
+      - opened
+jobs:
+  add_to_product_board:
+    uses: flowfuse/.github/.github/workflows/project-automation.yml@main
+    secrets:
+      token: ${{ secrets.PROJECT_ACCESS_TOKEN }}

package/.github/workflows/release-publish.yml

@@ -0,0 +1,18 @@
+name: Release Published
+on:
+    push:
+        tags:
+            - 'v*.*.*'
+
+jobs:
+    publish:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v1
+            - uses: actions/setup-node@v1
+              with:
+                  node-version: 16
+            - run: npm ci --omit dev
+            - uses: JS-DevTools/npm-publish@v1
+              with:
+                  token: ${{ secrets.NPM_PUBLISH_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,108 @@
+#### 1.14.0: Release
+
+ - Add support for Private CA (#75) @hardillb
+
+#### 1.13.0: Release
+
+ - Expose cpu/mem limits (#73) @hardillb
+ - Update ff references in package.json (#72) @knolleary
+ - Reusable workflow reference name change (#71) @ppawlowski
+
+#### 1.12.0: Release
+
+
+#### 1.11.0: Release
+
+ - Bump word-wrap from 1.2.3 to 1.2.5 (#68) @app/dependabot
+
+#### 1.10.1: Release
+
+ - Fix editor path (#66) @hardillb
+
+#### 1.10.0: Release
+
+ - Chore: Set root flag in eslint (#63) @Pezmc
+
+#### 1.9.0: Release
+
+ - Allow hosting domain to be changed (#60) @hardillb
+ - Add package-lock.json (#61) @Pezmc
+
+#### 1.8.0: Release
+
+ - Fix Delete suspended projects (#57) @hardillb
+
+#### 1.7.0: Release
+
+
+#### 1.6.0: Release
+
+
+#### 1.5.0: Release
+
+
+#### 1.4.0: Release
+
+
+#### 1.3.0: Release
+
+
+#### 1.2.0: Release
+
+
+#### 1.1.0: Release
+
+ - Add getDefaultStackProperies (#46) @hardillb
+ - Add flags to inhibit TCP/UDP inbound connections (#45) @Steve-Mcl
+ - Add guard for deleting suspended projects (#44) @hardillb
+
+#### 1.0.0: Release
+
+ - Add LetsEncypt env var if https enabled
+ - Update eslint (#42) @knolleary
+
+#### 0.10.0: Release
+
+
+#### 0.9.0: Release
+
+ - Use project.safeName (#37) @hardillb
+
+#### 0.8.0: Release
+
+ - Add licenseType to launcher env (#34) @knolleary
+ - add env var FORGE_TEAM_ID (#33) @Steve-Mcl
+ - Better start up exp 586 (#32) @hardillb
+ - Add FORGE_BROKER_* credentials to launcher env (#30) @knolleary
+
+#### 0.7.0: Release
+
+ - Fix log call when revoking Node-RED sessions (#29) @knolleary
+
+#### 0.6.0: Release
+
+ - Map FlowForge logout to nodered auth/revoke (#24) @Steve-Mcl
+ - Throw proper errors when actions performed on unknown project (#25) @knolleary
+ - Add FORGE_NR_SECRET env if project has credSecret set (#23) @knolleary
+ - Add Stack Properties descriptions (#21) @hardillb
+
+#### 0.5.0: Release
+
+#### 0.4.0: Release
+
+ - Update to use new container driver API (#17) @knolleary
+ - Fix validator regex for CPU % (#16) @hardillb
+ - Update project automation (#18) @knolleary
+
+#### 0.3.0: Release
+
+ - Stop driver setting baseURL/forgeURL (#14) @knolleary
+ - Add Stack support (#13) @hardillb
+ - Automate npm publish on release (#12) @hardillb
+
+#### 0.2.0: Release
+
+ - Update deps for security issues (#10) @hardillb
+ - Add shutdown hook (#9) @hardillb
+ - Make project URL schema match base_url (#8) @hardillb
+ - Add project workflow automation (#6) @knolleary

package/LICENSE

@@ -0,0 +1,178 @@
+Copyright FlowForge Inc, and other contributors, https://flowforge.com/
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,25 @@
+# FlowFuse Docker Container Driver
+
+FlowFuse driver to create projects as docker containers
+
+## Configuration
+
+In the `flowforge.yml` file
+
+```yaml
+...
+driver:
+  type: docker
+  options:
+    socket: /var/run/docker.sock
+    registry: containers.flowforge.com
+    privateCA: /full/path/to/chain.pem
+```
+
+ - `registry` is the Docker Registry to load Stack Containers from (default: Docker Hub)
+ - `socket` is the path to the docker unix domain socket (default: /var/run/docker.sock)
+ - privateCA: is the fully qualified path to a pem file containing trusted CA cert chain (default: not set)
+
+### Configuration via environment variables
+
+ - `DOCKER_SOCKET` - Path to docker unix domain socket

package/docker.js

@@ -0,0 +1,446 @@
+const fs = require('fs')
+const got = require('got')
+const Docker = require('dockerode')
+
+const createContainer = async (project, domain) => {
+    const networks = await this._docker.listNetworks({ filters: { label: ['com.docker.compose.network=flowforge'] } })
+    const stack = project.ProjectStack.properties
+    const contOptions = {
+        Image: stack.container,
+        name: project.id, // options.name,
+        Env: [],
+        Labels: {
+            flowforge: 'project'
+        },
+        AttachStdin: false,
+        AttachStdout: false,
+        AttachStderr: false,
+        HostConfig: {
+            NetworkMode: networks[0].Name
+        }
+    }
+
+    if (stack) {
+        if (stack.cpu) {
+            contOptions.HostConfig.NanoCpus = ((Number(stack.cpu) / 100) * (10 ** 9))
+        }
+        if (stack.memory) {
+            contOptions.HostConfig.Memory = Number(stack.memory) * (1024 * 1024)
+        }
+    }
+
+    // TODO http/https needs to be dynamic (or we just enforce https?)
+    // and port number
+    const baseURL = new URL(this._app.config.base_url)
+    let projectURL
+    if (!project.url.startsWith('http')) {
+        projectURL = `${baseURL.protocol}//${project.safeName}.${this._options.domain}`
+    } else {
+        const temp = new URL(project.url)
+        projectURL = `${temp.protocol}//${temp.hostname}${temp.port ? ':' + temp.port : ''}`
+    }
+    const url = new URL(projectURL)
+    const hostname = url.hostname
+    const teamID = this._app.db.models.Team.encodeHashid(project.TeamId)
+    const authTokens = await project.refreshAuthTokens()
+
+    // AuthProvider
+    contOptions.Env.push('FORGE_CLIENT_ID=' + authTokens.clientID)
+    contOptions.Env.push('FORGE_CLIENT_SECRET=' + authTokens.clientSecret)
+    // TODO this needs to come from a central point
+    contOptions.Env.push('FORGE_URL=' + this._app.config.api_url)
+    contOptions.Env.push(`BASE_URL=${projectURL}`)
+    contOptions.Env.push(`VIRTUAL_HOST=${hostname}`)
+    if (baseURL.protocol === 'https:') {
+        contOptions.Env.push(`LETSENCRYPT_HOST=${hostname}`)
+    }
+    contOptions.Env.push('VIRTUAL_PORT=1880')
+    // httpStorage settings
+    contOptions.Env.push(`FORGE_PROJECT_ID=${project.id}`)
+    contOptions.Env.push(`FORGE_PROJECT_TOKEN=${authTokens.token}`)
+    // Inbound connections for docker disabled by default
+    contOptions.Env.push('FORGE_NR_NO_TCP_IN=true') // MVP. Future iteration could present this to YML or UI
+    contOptions.Env.push('FORGE_NR_NO_UDP_IN=true') // MVP. Future iteration could present this to YML or UI
+    // common
+    contOptions.Env.push(`FORGE_TEAM_ID=${teamID}`)
+    // broker settings
+    if (authTokens.broker) {
+        contOptions.Env.push(`FORGE_BROKER_URL=${authTokens.broker.url}`)
+        contOptions.Env.push(`FORGE_BROKER_USERNAME=${authTokens.broker.username}`)
+        contOptions.Env.push(`FORGE_BROKER_PASSWORD=${authTokens.broker.password}`)
+    }
+    if (this._app.license.active()) {
+        contOptions.Env.push('FORGE_LICENSE_TYPE=ee')
+    }
+
+    if (stack.memory) {
+        contOptions.Env.push(`FORGE_MEMORY_LIMIT=${stack.memory}`)
+    }
+
+    if (stack.cpu) {
+        contOptions.Env.push(`FORGE_CPU_LIMIT=${stack.cpu}`)
+    }
+
+    const credentialSecret = await project.getSetting('credentialSecret')
+    if (credentialSecret) {
+        contOptions.Env.push(`FORGE_NR_SECRET=${credentialSecret}`)
+    }
+
+    if (this._app.config.driver.options.privateCA && fs.existsSync(this._app.config.driver.options.privateCA)) {
+        contOptions.Binds = [
+            `${this._app.config.driver.options.privateCA}:/usr/local/ssl-certs/chain.pem`
+        ]
+        contOptions.Env.push('NODE_EXTRA_CA_CERTS=/usr/local/ssl-certs/chain.pem')
+    }
+
+    const container = await this._docker.createContainer(contOptions)
+    return container.start()
+        .then(async () => {
+            this._app.log.debug(`Container ${project.id} started [${container.id.substring(0, 12)}]`)
+            project.url = projectURL
+            project.state = 'running'
+            await project.save()
+            this._projects[project.id].state = 'starting'
+        })
+}
+
+/**
+ * Docker Container driver
+ *
+ * Handles the creation and deletation of containers to back Projects
+ *
+ * This driver creates Projects backed by Docker
+ *
+ * @module docker
+ * @memberof forge.containers.drivers
+ *
+ */
+module.exports = {
+    /**
+     * Initialises this driver
+     * @param {string} app - the Vue application
+     * @param {object} options - A set of configuration options for the driver
+     * @return {forge.containers.ProjectArguments}
+     */
+    init: async (app, options) => {
+        this._app = app
+        this._projects = {}
+        this._docker = new Docker({
+            socketPath: app.config.driver.options?.socket || '/var/run/docker.sock'
+        })
+        this._options = options
+
+        if (!options.registry) {
+            options.registry = app.config.driver.options?.registry || '' // use docker hub
+        }
+
+        // Get a list of all projects - with the absolute minimum of fields returned
+        const projects = await app.db.models.Project.findAll({
+            attributes: [
+                'id',
+                'state',
+                'ProjectStackId',
+                'TeamId'
+            ]
+        })
+        projects.forEach(async (project) => {
+            if (this._projects[project.id] === undefined) {
+                this._projects[project.id] = {
+                    state: 'unknown'
+                }
+            }
+        })
+
+        this._initialCheckTimeout = setTimeout(() => {
+            this._app.log.debug('[docker] Restarting projects')
+            projects.forEach(async (project) => {
+                try {
+                    if (project.state === 'suspended') {
+                        // Do not restart suspended projects
+                        return
+                    }
+                    let container
+                    try {
+                        container = await this._docker.listContainers({
+                            all: true,
+                            filters: {
+                                name: [project.id]
+                            }
+                        })
+                        if (container[0]) {
+                            container = await this._docker.getContainer(container[0].Id)
+                        } else {
+                            container = undefined
+                        }
+                    } catch (err) {
+                        console.log(err)
+                    }
+                    if (container) {
+                        const state = await container.inspect()
+                        if (!state.State.Running) {
+                            this._projects[project.id].state = 'starting'
+                            this._app.log.debug(`[docker] Project ${project.id} - restarting container [${container.id.substring(0, 12)}]`)
+                            // need to restart existing container
+                            container.start().then(() => {
+                                this._projects[project.id].state = 'started'
+                            })
+                        } else {
+                            this._app.log.debug(`[docker] Project ${project.id} - already running container [${container.id.substring(0, 12)}]`)
+                            this._projects[project.id].state = 'started'
+                        }
+                    } else {
+                        this._app.log.debug(`[docker] Project ${project.id} - recreating container`)
+                        const fullProject = await this._app.db.models.Project.byId(project.id)
+                        // need to create
+                        await createContainer(fullProject, this._options.domain)
+                    }
+                } catch (err) {
+                    this._app.log.error(`[docker] Project ${project.id} - error resuming project: ${err.stack}`)
+                }
+            })
+        }, 1000)
+
+        return {
+            stack: {
+                properties: {
+                    cpu: {
+                        label: 'CPU Cores (%)',
+                        validate: '^([1-9][0-9]?|100)$',
+                        invalidMessage: 'Invalid value - must be a number between 1 and 100',
+                        description: 'How much of a single CPU core each Project should receive'
+                    },
+                    memory: {
+                        label: 'Memory (MB)',
+                        validate: '^[1-9]\\d+$',
+                        invalidMessage: 'Invalid value - must be a number',
+                        description: 'How much memory the container for each Project will be granted, recommended value 256'
+                    },
+                    container: {
+                        label: 'Container Location',
+                        // taken from https://stackoverflow.com/a/62964157
+                        validate: '^(([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])\\.)*([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])(:[0-9]+\\/)?(?:[0-9a-z-]+[/@])(?:([0-9a-z-]+))[/@]?(?:([0-9a-z-]+))?(?::[a-z0-9\\.-]+)?$',
+                        invalidMessage: 'Invalid value - must be a Docker image',
+                        description: 'Container image location, can include a tag'
+                    }
+                }
+            }
+        }
+    },
+    /**
+     * Start a Project
+     * @param {*}  - id for the project
+     * @return {forge.containers.Project}
+     */
+    start: async (project) => {
+        this._projects[project.id] = {
+            state: 'starting'
+        }
+        const rs = createContainer(project, this._options.domain)
+        return rs
+    },
+    /**
+     * Stops the container and removes it
+     * @param {*} project
+     */
+    stop: async (project) => {
+        // There is no difference in docker between suspending and stopping the container
+        // as we have no additional state to maintain
+        const container = await this._docker.getContainer(project.id)
+        this._projects[project.id].state = 'suspended'
+        await container.stop()
+
+        // We remove the container even though this is only a stop, so that a
+        // restart can rebuild with a different container image if needed.
+        // An alternative would be to spot the required image had changed on
+        // start, and do the remove/create/start at that point in time.
+        await container.remove()
+    },
+    /**
+     * Removes a Project
+     * @param {string} id - id of project to remove
+     * @return {Object}
+     */
+    remove: async (project) => {
+        if (this._projects[project.id].state !== 'suspended') {
+            try {
+                const container = await this._docker.getContainer(project.id)
+                await container.stop()
+                await container.remove()
+            } catch (err) {}
+        }
+        delete this._projects[project.id]
+    },
+    /**
+     * Retrieves details of a project's container
+     * @param {string} id - id of project to query
+     * @return {Object}
+     */
+    details: async (project) => {
+        if (this._projects[project.id] === undefined) {
+            return { state: 'unknown' }
+        }
+        if (this._projects[project.id].state === 'suspended') {
+            // We should only poll the launcher if we think it is running.
+            // Otherwise, return our cached state
+            return {
+                state: this._projects[project.id].state
+            }
+        }
+        const containers = await this._docker.listContainers({})
+        let found = false
+        let response
+        for (let index = 0; index < containers.length; index++) {
+            const container = containers[index]
+            if (container.Names[0].endsWith(project.id)) {
+                found = true
+                const infoURL = 'http://' + project.id + ':2880/flowforge/info'
+                try {
+                    response = await got.get(infoURL, {
+                        timeout: {
+                            request: 500
+                        }
+                    }).json()
+                    this._projects[project.id].state = 'running'
+                    break
+                } catch (err) {
+                    response = {
+                        id: project.id,
+                        state: 'starting',
+                        meta: {}
+                    }
+                }
+            }
+        }
+        if (found) {
+            return response
+        } else {
+            return {
+                id: project.id,
+                state: 'starting',
+                meta: {}
+            }
+        }
+        // const infoURL = 'http://' + project.id + ':2880/flowforge/info'
+        // try {
+        //     const info = JSON.parse((await got.get(infoURL),{
+        //         timeout: {
+        //             request: 500
+        //         }
+        //     }).body)
+        //     this._projects[project.id].state = 'running'
+        //     return info
+        // } catch (err) {
+        //     // TODO
+        //     // return
+        //     return {
+        //         id: project.id,
+        //         state: 'starting'
+        //     }
+        // }
+    },
+    /**
+     * Returns the settings for the project
+     */
+    settings: async (project) => {
+        // let project = await this._app.db.models.DockerProject.byId(id)
+        // const projectSettings = await project.getAllSettings()
+        // let options = JSON.parse(project.options)
+        const settings = {}
+        settings.projectID = project.id
+        settings.port = 1880
+        settings.rootDir = '/'
+        settings.userDir = 'data'
+
+        return settings
+    },
+    /**
+     * Starts the flows
+     * @param {string} id - id of project to start
+     * @return {forge.Status}
+     */
+    startFlows: async (project) => {
+        if (this._projects[project.id] === undefined) {
+            return { state: 'unknown' }
+        }
+        await got.post('http://' + project.id + ':2880/flowforge/command', {
+            json: {
+                cmd: 'start'
+            }
+        })
+    },
+    /**
+     * Stops the flows
+     * @param {string} id - id of project to stop
+     * @return {forge.Status}
+     */
+    stopFlows: async (project) => {
+        if (this._projects[project.id] === undefined) {
+            return { state: 'unknown' }
+        }
+        await got.post('http://' + project.id + ':2880/flowforge/command', {
+            json: {
+                cmd: 'stop'
+            }
+        })
+    },
+    /**
+     * Restarts the flows
+     * @param {string} id - id of project to restart
+     * @return {forge.Status}
+     */
+    restartFlows: async (project) => {
+        if (this._projects[project.id] === undefined) {
+            return { state: 'unknown' }
+        }
+        await got.post('http://' + project.id + ':2880/flowforge/command', {
+            json: {
+                cmd: 'restart'
+            }
+        })
+    },
+    /**
+   * Logout Node-RED instance
+   * @param {Project} project - the project model instance
+   * @param {string} token - the node-red token to revoke
+   * @return {forge.Status}
+   */
+    revokeUserToken: async (project, token) => { // logout:nodered(step-3)
+        try {
+            this._app.log.debug(`[docker] Project ${project.id} - logging out node-red instance`)
+            await got.post('http://' + project.id + ':2880/flowforge/command', { // logout:nodered(step-4)
+                json: {
+                    cmd: 'logout',
+                    token
+                }
+            })
+        } catch (error) {
+            this._app.log.error(`[docker] Project ${project.id} - error in 'revokeUserToken': ${error.stack}`)
+        }
+    },
+    logs: async (project) => {
+        if (this._projects[project.id] === undefined) {
+            return { state: 'unknown' }
+        }
+        return await got.get('http://' + project.id + ':2880/flowforge/logs').json()
+    },
+    /**
+     * Shutdown Driver
+     */
+    shutdown: async () => {
+        clearTimeout(this._initialCheckTimeout)
+    },
+    /**
+     * getDefaultStackProperties
+     */
+    getDefaultStackProperties: () => {
+        // need to work out what the right container tag is
+        const properties = {
+            cpu: 10,
+            memory: 256,
+            container: 'flowforge/node-red',
+            ...this._app.config.driver.options?.default_stack
+        }
+
+        return properties
+    }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+    "name": "@flowfuse/driver-docker",
+    "version": "1.14.0",
+    "description": "Docker driver for FlowFuse",
+    "main": "docker.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "lint": "eslint -c .eslintrc *.js",
+        "lint:fix": "eslint -c .eslintrc *.js --fix"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/FlowFuse/driver-docker.git"
+    },
+    "bugs": {
+        "url": "https://github.com/FlowFuse/driver-docker/issues"
+    },
+    "homepage": "https://github.com/FlowFuse/driver-docker#readme",
+    "author": {
+        "name": "FlowFuse Inc."
+    },
+    "license": "Apache-2.0",
+    "dependencies": {
+        "dockerode": "^3.3.1",
+        "got": "^11.8.0"
+    },
+    "devDependencies": {
+        "eslint": "^8.25.0",
+        "eslint-config-standard": "^17.0.0"
+    }
+}