Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
To set up your Spreedbox, a network connection is required. The Spreedbox has integrated Ethernet which is configured to use DHCP by default and tries to register as host
spreedbox on the network.
Every time your Spreedbox has no Ethernet link and no other network connection can be established 1 minute after booting the Spreedbox, it will automatically start an encrypted Wi-Fi hotspot with the SSID
spreedbox. See Setup with Wi-Fi for details.
- Connect your Spreedbox to Ethernet.
- Connect your Spreedbox to power using the power supply and wait until LEDs stop blinking red.
- Open up a web browser and access https://spreedbox/.
- Accept self-signed TLS certificate.
- Create initial user account.
- Start using your Spreedbox.
Starting the Spreedbox
To start the Spreedbox, just connect it to power with the power supply. The Spreedbox LEDs will start flashing red after about 20 seconds, indicating that the Spreedbox is preparing itself.
On first boot, the Spreedbox will automatically resize the storage to use the full size of the SD card and generate keys/certificates for the various encrypted services, including a self-signed TLS certificate and the SSH server keys. The first boot might take longer (approx. 30 seconds), depending on the size of your SD card.
When finished preparing, the Spreedbox LEDs will shine in a steady light blue (the Spreed.ME color). This LED state is the normal operation default state and your Spreedbox will usually show this color.
Setup with LAN
After having plugged in a network cable into the Ethernet connector of the Spreedbox, DHCP will be used to automatically obtain the network configuration. The Spreedbox will try to register itself as
spreedbox on the network. So either use this name to connect, or check your router for the IP address that was given to the Spreedbox. To help identify your Spreedbox on the network, the Ethernet MAC address is printed on the label which was shipped together with your Spreedbox. All further steps assume that the Spreedbox is reachable as
spreedbox in the local network. If not, replace the hostname with the IP address as given by your router.
To continue setting up your Spreedbox, you need a web browser. Either use a PC or a smartphone. Make sure this device is on the same network as your Spreedbox and open up the web address https://spreedbox/. This will show the Nextcloud sign-in page where you will have to create the initial administrator user account. Enter a username and password of your choice and the basic Spreedbox setup is done.
Setup with Wi-Fi
In case you cannot set up the Spreedbox with Ethernet, the Spreedbox will automatically start a Wi-Fi hotspot after 1 minute without network connection. This Wi-Fi hotspot can only be used to complete and change the Spreedbox network configuration by having the Spreedbox join into your Wi-Fi network.
The Wi-Fi hotspot is using WPA2 encryption with a pre-shared key (WPA2 personal). The wireless password depends on your Spreedbox hardware and is printed on the label shipped with your Spreedbox.
Change network configuration
To modify the Spreedbox configuration, a setup web interface is available on https://spreedbox/spreedbox-setup. It will automatically start the setup wizard to configure the Spreedbox.
The name of your Spreedbox is the name under which it is reachable on the network.
You have to choose what kind of network connection you want to use with your Spreedbox. If the Wi-Fi adapter is plugged in, you can have the Spreedbox join your Wi-Fi network. Otherwise, only the Ethernet option is available.
If you have selected Wi-Fi, the Spreedbox will automatically scan for available Wi-Fi networks and show a list. Select the Wi-Fi network to join and enter the required credentials. If your Wi-Fi network is not on the list, try to join a hidden Wi-Fi by entering details of your Wi-Fi network.
The Spreedbox can use automatic configuration via DHCP (default) or a static network configuration. Use DHCP if unsure.
Before applying the new settings, the setup will show an overview so you can double-check the settings. Fear not, your Spreedbox does check the settings and revert them in case they do not work after 1 minute. Optionally, you can disable this safety check.
Once you hit the "Save" button, the configuration is applied and a counter will show up while the validation is in progress. If everything goes well, a success page is shown and the new configuration will be permanent.
Make sure that your PC/smartphone is on the same network as the one you just configured. You have 60 seconds to do the change. Do not press reload while the graceful timer is running.
In case that you chose DHCP to configure the Spreedbox, the hostname will be used to verify that the new network configuration does work. If your network or DHCP server does not support hostname assignment, you either have to set up DNS in your router for the Spreedbox (and use that name as Spreedbox name) or disable the validation.
Reset Spreedbox network configuration
In case you have lost access to your Spreedbox because of a no longer working network configuration, remember that after 1 minute the Spreedbox will launch its Wi-Fi hotspot.
If that does not help, remove the SD card from the Spreedbox and plug it into your computer. On the first partition, create a file
reset-network-configuration (it is a partition with Windows VFAT file system). When the Spreedbox detects that file on boot, it will automatically reset the network configuration to the defaults and then remove the file.