mait.sh1.69.2

Private beta: features and content may change. No warranty; use at your own risk.

Docs / Image

MAIT image project settings

Choose a release and a variant, set the working user, and request the workspace facilities your project needs.

These settings live in your project definition; AIDC Launch reads them when it starts the workspace.

A setting is a request that AIDC Launch resolves for your computer.

Advanced
Problems and fixes

Choosing a release

SettingWhat to choose
Imageghcr.io/mait-sh/mait:<version>
Workspace optionsghcr.io/mait-sh/mait-features:<same version>
Full versionNames one release; use it when every machine must match
Major or minor tagFollows the latest release on that line, so it can change
Ubuntu variantAdd a suffix such as -ubuntu2404 to choose another Ubuntu version
Setting
Image
What to choose
ghcr.io/mait-sh/mait:<version>
Setting
Workspace options
What to choose
ghcr.io/mait-sh/mait-features:<same version>
Setting
Full version
What to choose
Names one release; use it when every machine must match
Setting
Major or minor tag
What to choose
Follows the latest release on that line, so it can change
Setting
Ubuntu variant
What to choose
Add a suffix such as -ubuntu2404 to choose another Ubuntu version

Your container engine picks Intel or ARM automatically. Write on and off choices as the literal strings on and off.

Working user

OptionDefaultWhat it sets
usernamedevThe account you work as
userid1000Its numeric user ID, written as a string
groupid1000Its numeric group ID, written as a string
additionalgroupsEmptyExtra groups, comma-separated
Option
username
Default
dev
What it sets
The account you work as
Option
userid
Default
1000
What it sets
Its numeric user ID, written as a string
Option
groupid
Default
1000
What it sets
Its numeric group ID, written as a string
Option
additionalgroups
Default
Empty
What it sets
Extra groups, comma-separated

Use the numeric IDs of your own account on your computer, so files you create in the workspace belong to you. AIDC Launch fills these in when it sets up the project.

Workspace facilities

OptionDefaultWhat it requests
securedonThe secure runtime, which isolates the workspace more strongly
dockerdoffon runs Docker inside the workspace, host uses your computer's Docker, off neither
x11onGraphical applications shown on your desktop
gpuautoGPU access; auto uses one when your computer offers it, off disables it
audiohosthost uses your computer's speakers and microphone, on gives the workspace its own, bridge does both, off disables sound
usboffon passes all USB devices, dynamic lets you attach them one at a time
aidevonShares your supported AI tools' settings and saved sign-in with the workspace
Option
secured
Default
on
What it requests
The secure runtime, which isolates the workspace more strongly
Option
dockerd
Default
off
What it requests
on runs Docker inside the workspace, host uses your computer's Docker, off neither
Option
x11
Default
on
What it requests
Graphical applications shown on your desktop
Option
gpu
Default
auto
What it requests
GPU access; auto uses one when your computer offers it, off disables it
Option
audio
Default
host
What it requests
host uses your computer's speakers and microphone, on gives the workspace its own, bridge does both, off disables sound
Option
usb
Default
off
What it requests
on passes all USB devices, dynamic lets you attach them one at a time
Option
aidev
Default
on
What it requests
Shares your supported AI tools' settings and saved sign-in with the workspace

Running Docker inside the workspace also turns on the secure runtime. After changing a setting, recreate the workspace with aidcx start --rebuild; no new image is needed. The AIDC Launch workspace settings explain how to set them from the command line.

What you getA project definition that states which environment it needs, so it opens from the same definition each time; pin the full version to match machines.