Installation

Via npm (recommended)

npm install -g @runeya/apps-cli
runeya

From source

git clone https://github.com/runeya/runeya.git
cd runeya
yarn install
yarn build
yarn dev

The interface is available at http://localhost:5173 in development mode.

System environment variables

Variable	Default	Description
RUNEYA_HTTP_PORT	9545	Local server port (takes priority over PORT)
PORT	9545	Server port (legacy — use RUNEYA_HTTP_PORT instead)
DATA_DIR	./.runeya	Project data directory
RUNEYA_AGENT_PORT	9546	Local agent port (default: RUNEYA_HTTP_PORT + 1)

Example:

RUNEYA_HTTP_PORT=8080 runeya

Data directory

Runeya creates ./.runeya/ in the current folder (or the path defined by DATA_DIR) with the following structure:

.runeya/
├── projects.json       # Projects
├── services.json       # Services and their configs
├── agents.json         # Registered agents (encrypted passphrases)
├── environments.json   # Global environments
├── settings.json       # Global settings + log parsers
├── schema-version.json # Data schema version
└── .encryption.key     # AES-256 key (600 perms, never committed)

WARNING

Never commit the .encryption.key file. It is used to encrypt your service secrets.

Updating

npm update -g @runeya/apps-cli

Uninstalling

npm uninstall -g @runeya/apps-cli
rm -rf .runeya   # removes current project data