down

The fujin down command tears down your application by stopping services and removing resources.

Overview

Use fujin down to remove your application from the server. The command runs the bundle’s uninstall script, which stops and disables systemd services, removes systemd unit files, cleans up Caddy configuration, deletes the application user, and removes the application directory.

Warning

This command removes your application from the server. The application directory and all files within it will be deleted. Use with caution.

Options

-f, --full

Also uninstall Caddy web server. Use this if you’re completely removing fujin from the server.

--force

Continue teardown even if the uninstall script fails. When set, forces removal of the app directory regardless of errors.

How it works

Here’s what happens when you run fujin down:

1. Prompt for confirmation: Shows a warning message about the irreversible action and asks for confirmation.

2. Read current version: Reads the version from the .version file to locate the bundle.

3. Run uninstall script: Executes the bundle’s uninstall script (python3 {bundle}.pyz uninstall) which: - Stops all systemd services - Disables services from auto-starting - Removes systemd unit files - Removes Caddy configuration (if webserver was enabled) - Deletes the application user

4. Remove app directory: Deletes the entire application directory (/opt/fujin/your-app).

5. Uninstall Caddy (if --full): Removes the Caddy web server from the system.

6. Log operation: Records the teardown to the audit log as either down or full-down.

If the uninstall script fails and --force is not set, the command exits with an error. With --force, it continues and force-removes the app directory using rm -rf.

See Also

• deploy - Deploy application

• up - Bootstrap server