# Surge documentation Surge is a terminal download manager that can run as an interactive TUI, a headless server, or a user service. Start with the path that matches what you want to do. ## Start here - [Install Surge](getting-started.md#install-surge) - [Make your first download](getting-started.md#make-your-first-download) - [Choose a mode](concepts/modes.md) ## Use Surge - [Download files from the terminal](guides/download-files.md) - [Use the interactive TUI](guides/use-the-tui.md) - [Run Surge as a service](guides/run-as-a-service.md) - [Connect to a remote server](guides/connect-to-a-remote-server.md) - [Customize themes, fonts, and keybindings](guides/customize-surge.md) ## Configure and automate - [Configuration reference](SETTINGS.md) - [Command-line reference and examples](reference/cli.md) - [How Surge optimizes downloads](OPTIMIZATIONS.md) ## Design notes - [User-service architecture and migration rationale](design/user-service-architecture.md) - [Nix release packaging and updates](design/nix-releases.md) ## Get help - [Troubleshooting](help/troubleshooting.md) - [Report a bug](https://github.com/SurgeDM/Surge/issues/new/choose) 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.