CoreOS Tectonic Sandbox

Get started quickly with Tectonic for demo and self-learning purposes.

Runs on your local machine, no external dependencies or credentials required

Great for evaluation purposes to deploy simple workloads

Prerequisites

Vagrant is a simple-to-use command line virtual machine manager. There are install packages available for Windows, Linux and OS X. Find the latest installer on the Vagrant downloads page. Be sure to get version 1.9.8 or greater.

Use the form above to download the Tectonic Sandbox

4 GB of available RAM

Not meant for production use cases

Getting Started

1. Fill out the form above. Once your download completes, unzip Tectonic Sandbox.

Open a terminal and run:

cd Downloads...
vagrant up --provider=virtualbox

2. Watch Sandbox install, and spin up your cluster. This should take 20-40 minutes, depending on your connection. When complete, follow the instructions provided in the terminal to log in to the Console.

  • Log in to your cluster using the Console URL displayed in the terminal. If you receive an error page saying that the connection is not private, click Advanced, then Proceed to log in.
  • Enter the username and password provided, and click Log In.

3. Try out Tectonic with your containers
Set up kubectl to interact with the cluster:

export KUBECONFIG=$PWD/etc/kubernetes/kubeconfig
kubectl get nodes

Hyper-V conflicts with VirtualBox, and must be disabled before launching Tectonic Sandbox.

Docker for Windows uses Hyper-V to run a Linux kernel. If Docker for Windows is installed, you must first disable Docker, then disable Hyper-V before launching Tectonic Sandbox. A reboot is required to enable or disable Hyper-V.

1. Configure machine

First, disable Docker.

Then, disable Hyper-V:

bcdedit /set hypervisorlaunchtype off

2. Fill out the form above. Download and unzip Tectonic Sandbox.

Open a powershell and run:

cd Downloads...
vagrant up --provider=virtualbox

To re-enable Hyper-V after exploring Tectonic Sandbox, run:

bcdedit /set hypervisorlaunchtype auto

3. Watch Sandbox install, and spin up your cluster. This should take 20-40 minutes, depending on your connection. When complete, follow the instructions provided in the terminal to log in to the Console.

  • Log in to your cluster using the Console URL displayed in the terminal. If you receive an error page saying that the connection is not private, click Advanced, then Proceed to log in.
  • Enter the username and password provided, and click Log In.

4. Try out Tectonic with your containers
Set up kubectl to interact with the cluster:

$env:KUBECONFIG = "$PWD\etc\kubernetes\kubeconfig"
kubectl get nodes

Debugging:

Q: My console doesn't work!

A: There are a few common problems that might prevent Tectonic Console from launching. Use these suggestions to try and resolve the issue.

First, confirm that you are using one of the supported browsers: Google Chrome, Mozilla Firefox, or Internet Explorer. Other browsers may not work with Tectonic Sandbox.

If you are using one of these browsers, try to resolve the Console on the local worker machine::

vagrant ssh w1
curl https://console.tectonic-local.coreos.com/

If that is failing, then see if there is anything listening on that port

vagrant ssh w1
netstat -nl | grep 443

If this doesn’t work, please wait five minutes, then rerun the commands. It can take some time for Kubernetes to resolve the request. If the Console is still unavailable, file an issue in the Tectonic Sandbox GitHub repo.

Q: I got this error:

==> c1: Failed to start tectonic.service: Unit tectonic.service not found.

A: You may be running a version of the vagrant image which does not support Ignition. To fix this, first, use vagrant destroy to remove the machines created during installation: vagrant destroy -f

Then, remove the old boxes:

vagrant box remove coreos-beta --all --provider=virtualbox

Q: It's been 20 minutes and my cluster still isn't coming up!

A: We know it is annoying but please wait 10 more minutes to file an issue. The installation must download 2GB+ of data between CoreOS Container Linux images and the required container images for Tectonic. A download of this size may take quite some time.

Q: I got a configuration error regarding VagrantPlugins::Ignition::Config:

A: You are running an older version of the vagrant-ignition plugin. Update the plugin using this command:

vagrant plugin update vagrant-ignition

Q: How do I view the Console?

A: Navigate to https://console.tectonic-local.coreos.com in your browser.

Q: How do I log in to the Console?

A: First, click through the "Your connection is not private" warning page. Click Advanced, and then Proceed. Then, enter user: “admin@example.com”, and password: “sandbox” to launch Tectonic Console.

Q: How do I use kubectl?

A: To use kubectl with the cluster, set the environment variable listed at the end of the vagrant up instructions.

On macOS or Linux, run:

export KUBECONFIG=$PWD/provisioning/etc/kubernetes/kubeconfig

On Windows, run:

$env:KUBECONFIG = "$PWD\provisioning\etc\kubernetes\kubeconfig"

Ready to deploy applications to Tectonic in a production environment?

Install Tectonic for free up to 10 nodes on AWS, Azure, and bare metal, or contact us to learn about our enterprise offerings beyond 10 nodes.