Synopsis
fishnet service install [--apply]
fishnet service uninstall [--apply]
Subcommands
install
Installs the system service configuration for automatic startup.
fishnet service install [--apply]
Apply the changes immediately. Without this flag, the command runs in dry-run mode and shows what would be done.
uninstall
Removes the system service configuration.
fishnet service uninstall [--apply]
Apply the changes immediately. Without this flag, the command runs in dry-run mode.
Examples
Install (dry-run)
Output (macOS):
Dry-run: service install plan
unit path: ~/Library/LaunchAgents/dev.fishnet.local.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>dev.fishnet.local</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/fishnet</string>
<string>start</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>
apply commands:
launchctl unload -w ~/Library/LaunchAgents/dev.fishnet.local.plist >/dev/null 2>&1 || true
launchctl load -w ~/Library/LaunchAgents/dev.fishnet.local.plist
Use --apply to execute.
Dry-run: service install plan
unit path: ~/.config/systemd/user/fishnet.service
[Unit]
Description=Fishnet local security proxy
After=network-online.target
[Service]
Type=simple
ExecStart=/usr/local/bin/fishnet start
Restart=on-failure
RestartSec=2
[Install]
WantedBy=default.target
apply commands:
systemctl --user daemon-reload
systemctl --user enable --now fishnet.service
Use --apply to execute.
Install (apply)
fishnet service install --apply
Service installed at ~/Library/LaunchAgents/dev.fishnet.local.plist
Uninstall (dry-run)
fishnet service uninstall
Dry-run: service uninstall plan
unit path: ~/Library/LaunchAgents/dev.fishnet.local.plist
launchctl unload -w ~/Library/LaunchAgents/dev.fishnet.local.plist >/dev/null 2>&1 || true
Use --apply to execute.
Dry-run: service uninstall plan
unit path: ~/.config/systemd/user/fishnet.service
systemctl --user disable --now fishnet.service || true
systemctl --user daemon-reload
Use --apply to execute.
Uninstall (apply)
fishnet service uninstall --apply
Behavior
macOS (LaunchAgent)
- Creates
~/Library/LaunchAgents/dev.fishnet.local.plist
- Configures automatic start on login with
RunAtLoad
- Enables automatic restart with
KeepAlive
- Uses
launchctl to load/unload the agent
Linux (systemd user service)
- Creates
~/.config/systemd/user/fishnet.service
- Configures automatic start on login
- Enables automatic restart on failure with 2-second delay
- Uses
systemctl --user commands
Error messages
Unsupported OS:
service install is not supported on this OS
failed to create service dir: <error>
failed to write service unit: <error>
command failed (exit status 1): systemctl --user enable --now fishnet.service
Exit codes
- 0 - Service installed/uninstalled successfully or dry-run completed
- 1 - Error occurred (unsupported OS, permission denied, command failed, etc.)
Manual service management
macOS
# Check status
launchctl list | grep fishnet
# Stop service
launchctl stop dev.fishnet.local
# Start service
launchctl start dev.fishnet.local
Linux
# Check status
systemctl --user status fishnet.service
# Stop service
systemctl --user stop fishnet.service
# Start service
systemctl --user start fishnet.service
# View logs
journalctl --user -u fishnet.service -f