Workspace

The configured workspace directory affects:

• the current working directory for tasks
• the relative directory for applying filters

By default, the workspace is /var/mint-workspace

Changing the Workspace

To change the workspace, you'll need to make a new directory with permissions corresponding to the desired user, and then write the path to $RWX_IMAGE/workspace

When Using the Base Config

We recommend using the default workspace directory if you're using the RWX base config. However, you can change it.

base:
  image: ubuntu:24.04
  config: rwx/base 1.0.0

tasks:
  - key: workspace
    run: |
      sudo mkdir /app
      sudo chown ubuntu:ubuntu /app
      echo "/app" > $RWX_IMAGE/workspace

  - key: check-workspace
    use: workspace
    run: echo $PWD

Only tasks which use: workspace or are downstream of a task which uses the workspace task will have its workspace changed. However, you likely will be cloning a git repository into the changed workspace, so including use: workspace on your git/clone task and then having everything downstream use: code will result in all tasks using the new workspace.

- key: code
  use: workspace
  call: git/clone 1.9.2
  with:
    repository: ...

Changing the Workspace with No Base Config

If you are not using the rwx/base 1.0.0 config, then your runs are mostly likely starting off running as root, so you will not need to use sudo or chown the new directory when defining a new workspace.

base:
  image: debian:trixie
  config: none

tasks:
  - key: workspace
    run: |
      mkdir /app
      echo "/app" > $RWX_IMAGE/workspace

  - key: code
    use: workspace
    call: git/clone 1.9.2
    with:
      repository: ...