ceylon run-js [--cacherep=<url>] [--compile[=<flags>]] [--cwd=<dir>] [--debug=<debug>] [--maven-overrides=<url>] [--no-default-repositories] [--node-exe=<node-exe>] [--offline] [--overrides=<url>] [--rep=<url>...] [--run=<func>] [--sysrep=<url>] [--timeout=<seconds>] [--verbose[=<flags>]] [--] <module>


Executes the ceylon program specified as the <module> argument. The <module> may optionally include a version.



Specifies the folder to use for caching downloaded modules. (default: ~/.ceylon/cache)


Determines if and how compilation should be handled. Allowed flags include: never, once, force, check.


Specifies the current working directory for this tool. (default: the directory where the tool is run from)


Shows more detailed output in case of errors.


Specifies the XML file to use to load Maven artifact overrides. See for information. Deprecated: use --overrides.


Indicates that the default repositories should not be used.


The path to the node.js executable. Will be searched in standard locations if not specified.

--offline, -L

Enables offline mode that will prevent connections to remote repositories.


Specifies the XML file to use to load module overrides. See for information. Experimental.


Specifies a module repository containing dependencies. Can be specified multiple times. (default: modules, ~/.ceylon/repo,


The function to run, which must be exported from the given <module>. (default: run).


Specifies the system repository containing essential modules. (default: $CEYLON_HOME/repo)

--timeout=seconds, -T seconds

Sets the timeout for connections to remote repositories, use 0 for no timeout (default: 20).

--verbose[=flags], -d

Produce verbose output. If no flags are given then be verbose about everything, otherwise just be verbose about the flags which are present. Allowed flags include: all, loader.

Configuration file

The run-js tool accepts the following option from the Ceylon configuration file: runtool.compile (the equivalent option on the command line always has precedence).


The following would execute the com.example.foobar module:

ceylon run-js com.example.foobar/1.0.0