Repository navigation
First Launch
When you start Nebulae for the first time, two things happen automatically before you see the main window.
A prompt asks whether you want the Media Center enabled. This controls whether the Media navigation button appears in the title bar and whether the optical cinema gallery is accessible.
- Choose Enable if you plan to use Nebulae with DVDs, Blu-rays, or ISO images.
- Choose Skip if you only need the torrent manager. You can change this later in Settings → BitTorrent → Media Mode.
Nebulae embeds a Tailscale daemon that creates an encrypted private tunnel to the ADC infrastructure. On first launch it enrolls automatically in the background.
- Launches the embedded
tailscaledprocess under Nebulae's supervisor. - Connects to the ADC Tailnet using your stored credentials.
- Assigns this machine a private Tailnet IP (e.g.
100.64.0.x) and registers it as a named node. - Starts a SOCKS5 proxy on
127.0.0.1:1055so the torrent engine can route tracker traffic through the private mesh.
The Tailnet indicator in the bottom status bar shows the connection state:
| Indicator | Meaning |
|---|---|
| White Tailnet dot | Connected to the tailnet |
| Green dot + ADC host verified reachable | Private route to ADC confirmed working |
| Amber dot + ADC host offline | ADC host unreachable on the private route |
| Amber dot + ADC unavailable | Tailnet connected but no ADC peer visible |
| Grey ADC unverified | Tailnet connected; probe result pending |
Probes run automatically every 10 minutes. You do not need to re-enroll after a restart; enrollment state persists across application restarts and supervisor restarts.
Once the engine starts and the daemon is enrolled:
- The main window opens in Torrent Manager view (or Media Center if you chose that).
- The bottom status bar shows the engine state, port, Tailnet connection, and transfer speeds.
- Open Settings (gear icon in the title bar) to set your Download Directory and any other preferences before adding your first torrent.
Next: The Main Window