-`login_before_ready` (Boolean, Deprecated) This option defines whether or not the user can (by default) login to the workspace before it is ready. Ready means that e.g. the startup_script is done and has exited. When enabled, users may see an incomplete workspace when logging in.

-`metadata` (Block List) Each "metadata" block defines a single item consisting of a key/value pair. This feature is in alpha and may break in future releases. (see[below for nested schema](#nestedblock--metadata))

-`motd_file` (String) The path to a file within the workspace containing a message to display to users when they login via SSH. A typical value would be /etc/motd.

-`shutdown_script` (String) A script to run before the agent is stopped. The script should exit when it is done to signal that the workspace can be stopped.

-`shutdown_script` (String) A script to run before the agent is stopped. The script should exit when it is done to signal that the workspace can be stopped. This option is an alias for defining a "coder_script" resource with "run_on_stop" set to true.

-`shutdown_script_timeout` (Number, Deprecated) Time in seconds until the agent lifecycle status is marked as timed out during shutdown, this happens when the shutdown script has not completed (exited) in the given time.

-`startup_script` (String) A script to run after the agent starts. The script should exit when it is done to signal that the agent is ready.

-`startup_script_behavior` (String) This option sets the behavior of the`startup_script`. When set to "blocking", the startup_script must exit before the workspace is ready. When set to "non-blocking", the startup_script may run in the background and the workspace will be ready immediately. Default is "non-blocking", although "blocking" is recommended.

-`startup_script` (String) A script to run after the agent starts. The script should exit when it is done to signal that the agent is ready. This option is an alias for defining a "coder_script" resource with "run_on_start" set to true.

-`startup_script_behavior` (String) This option sets the behavior of the"startup_script". When set to "blocking", the startup_script must exit before the workspace is ready. When set to "non-blocking", the startup_script may run in the background and the workspace will be ready immediately. Default is "non-blocking", although "blocking" is recommended. This option is an alias for defining a "coder_script" resource with "start_blocks_login" set to true (blocking).

-`startup_script_timeout` (Number, Deprecated) Time in seconds until the agent lifecycle status is marked as timed out during start, this happens when the startup script has not completed (exited) in the given time.

-`troubleshooting_url` (String) A URL to a document with instructions for troubleshooting problems with the agent.

-`agent_id` (String) The "id" property of a "coder_agent" resource to associate with.

-`display_name` (String) The display name of the script to display logs in the dashboard.

-`script` (String) The scriptto run.

-`script` (String) Thecontent of thescriptthat will be run.

-`cron` (String) The cron schedule to run the script on. This is a cron expression.

-`icon` (String) A URL to an icon that will display in the dashboard. View built-in icons here:https://github.com/coder/coder/tree/main/site/static/icon. Use a built-in icon with`data.coder_workspace.me.access_url + "/icon/<path>"`.

-`log_path` (String) The path of a file to write the logs to. If relative, it will be appended to tmp.

-`run_on_start` (Boolean) This option defines whether or not the script should run when the agent starts.

-`run_on_stop` (Boolean) This option defines whether or not the script should run when the agent stops.

-`start_blocks_login` (Boolean) This optiondefines whetheror not the user can (by default) login to the workspacebeforethis scriptcompletes running on start. Whenenabled, users maysee an incomplete workspace when logging in.

-`timeout` (Number) Time in secondsuntil the agent lifecycle status is marked as timed out, this happens when the script has not completed (exited) in the given time.

-`run_on_start` (Boolean) This option defines whether or not the script should run when the agent starts. The script should exit when it is done to signal that the agent is ready.

-`run_on_stop` (Boolean) This option defines whether or not the script should run when the agent stops. The script should exit when it is done to signal that the workspace can be stopped.

-`start_blocks_login` (Boolean) This optiondetermines whetherusers can log in immediately or must wait for the workspaceto finish runningthis scriptupon startup. If notenabled, users mayencounter an incomplete workspace when logging in. This option only sets the default, the user can still manually override the behavior.

-`timeout` (Number) Time in secondsthat thescript is allowed to run. If the script does not complete within this time, the script is terminated and theagent lifecycle status is marked as timed out. A value of zero (default) means no timeout.