Commands

exodus

The magic command. Runs connect → init → build → deploy as needed.

exodus [cwd]

Flag	Description
-d, --dirty	Use working directory instead of latest git commit
-m, --method <method>	Build method: local, hybrid, remote, auto
--skip-health-check	Skip health check after container start
--no-env	Skip all env injection
--no-secrets	Skip server secrets injection

# Deploy current working directory
exodus --dirty

# Force remote build
exodus --method remote

---

exodus connect

Connect and provision a new VPS. Interactive prompts for SSH credentials.

exodus connect

Installs Docker, Caddy, configures firewall. Credentials stored in ~/.config/exodus/config.yml.

---

exodus init

Initialize a project for deployment.

exodus init [cwd]

Flag	Description
-F, --force	Overwrite existing exodus.yml

Creates exodus.yml in your project root.

---

exodus build

Build and push your app image to the server.

exodus build [cwd]

Flag	Description
-d, --dirty	Use working directory instead of latest git commit
-m, --method <method>	Build method: local, hybrid, remote, auto
--no-env	Skip all env injection
--no-secrets	Skip fetching server secrets

# Build from current files (not git)
exodus build --dirty

# Build on server
exodus build --method remote

---

exodus deploy

Deploy a built image. Requires exodus build first.

exodus deploy [cwd]

Flag	Description
--skip-health-check	Skip health check after container start

---

exodus ssh

SSH into a connected server.

exodus ssh [server]

Opens interactive SSH session. If no server specified, prompts for selection.

---

exodus ps

List running containers for the current project.

exodus ps [cwd]

---

exodus logs

View container logs.

exodus logs [cwd]

Flag	Description
-f, --follow	Follow log output (like tail -f)
-n, --lines <number>	Number of lines to show (default: 100)

# Follow logs
exodus logs -f

# Last 50 lines
exodus logs -n 50

---

exodus restart

Restart running containers.

exodus restart [cwd]

Restarts all running containers for the project. Useful after updating secrets.

---

exodus rollback

Rollback to a previous deployment.

exodus rollback [cwd]

Flag	Description
-v, --version <version>	Specific version (container name or image tag)

# Interactive selection
exodus rollback

# Rollback to specific version
exodus rollback -v exodus-myapp-1234567890

---

exodus dns

Check and verify DNS configuration for custom domains.

exodus dns

Interactive wizard to verify A records point to your server. Supports Cloudflare proxy detection.

---

exodus secrets

Manage environment secrets on the server.

exodus secrets

Interactive mode when called without subcommand.

secrets list

exodus secrets list

Flag	Description
-d, --dir <path>	Project directory

secrets set

exodus secrets set [KEY=VALUE...]

Flag	Description
-d, --dir <path>	Project directory
-f, --from-env <file>	Import from .env file

# Set single secret
exodus secrets set DATABASE_URL=postgres://...

# Set multiple
exodus secrets set API_KEY=xxx STRIPE_KEY=yyy

# Import from file
exodus secrets set -f .env.production

secrets unset

exodus secrets unset [keys...]

Flag	Description
-d, --dir <path>	Project directory

exodus secrets unset API_KEY STRIPE_KEY

secrets pull

Download server secrets to local file.

exodus secrets pull

Flag	Description
-d, --dir <path>	Project directory
-o, --output <file>	Output file (default: .env.exodus)
-f, --force	Overwrite without prompting

secrets push

Upload local env file to server.

exodus secrets push

Flag	Description
-d, --dir <path>	Project directory
-i, --input <file>	Input file (default: .env.exodus)
-f, --force	Push without confirmation
--dry-run	Show changes without applying

# Preview changes
exodus secrets push --dry-run

# Force push
exodus secrets push -f