Ocean Documentation
OCEAN IS IN BETA!
This guide applies to the Ocean BETA units that will ship in February 2016.
If you find a bug while using your Ocean and would like to report it, please send us an email about it!
Welcome to the Ocean documentation website! This site contains a growing collection of guides and tutorials for setting up your Ocean and getting the most out of it.
Powering your Ocean
IMPORTANT: The GREEN LIGHTS are BATTERY INDICATORS ONLY!
They will always glow green while your Ocean has battery power.
To power on your Ocean, hold the central power button for at least two seconds until you see red lights glowing from within the case.
- More information about powering your Ocean on and off
- About the various LEDs on the Ocean, and what they mean
Getting Started
Prerequisites
To communicate with your Ocean via another computer, some tools may be required. Check the following guides to see if you need to install anything.
Setup Your Ocean WiFi Over USB
Ocean is a computer running the Linux operating system. The Ocean is set up to function like a traditional Linux server, in that you do not directly interact with the Ocean via a screen or mouse. Instead, you connect to the device with a remote terminal over a network.
However, since our device does not contain a direct ethernet port, the method for doing this involves a USB connection. Ocean is intended to be used wirelessly, so you should only need to use the USB connection once, when setting up the Ocean for the first time.
Connect to Your Ocean With SSH
Once you've setup WiFi on your Ocean, you'll want to begin communicating with it. ssh
is a program that allows secure communication over a network. The following guides explain how to use ssh
to talk to your Ocean on your operating system of choice.
- Connect to your Ocean with ssh on OSX
- Connect to your Ocean with ssh on Linux
- Connect to your Ocean with ssh on Windows
Guides and Tutorials
Setup a Static Web Server
It's very easy to set up a web server on your Ocean that can serve static HTML files. This guide explains how to do it.
Add Another WiFi Network
A wifi setup tool is already installed by default on all Oceans.
You can also add WiFi networks manually by editing the wpa_supplicant
config files.
Troubleshooting
Fix Filesystem Errors with fsck
Most Linux distributions have a utility called fsck
that can automatically fix many filesystem problems. This section explains how to run fsck
on your Ocean.
Working on Ocean
Open Source
Our source code repositories are available on github here.
About the Ocean OS
All Oceans come pre-installed with a customized version of Debian Jessie, using version 3.4.105 of the Linux kernel.