Surge documentation

Surge is a terminal download manager that can run as an interactive TUI, a headless server, or a system service. Start with the path that matches what you want to do.

Start here

• Install Surge
• Make your first download
• Choose a mode

Use Surge

• Download files from the terminal
• Use the interactive TUI
• Run Surge as a service
• Connect to a remote server
• Customize themes, fonts, and keybindings

Configure and automate

• Configuration reference
• Command-line reference and examples
• How Surge optimizes downloads

Get help

• Troubleshooting
• Report a bug

The documentation is maintained with the Surge source. Please open an issue or pull request when a command, default, or example does not match the release you are using.