Logging In - How to login to the dokku server unix command line

This page explains how to login to the Dokku command line.

If you already know your dokku host, and have configured your account to access dokku, it should be as simple as this:

1. Login to CSIL
2. From there, type ssh dokku-nn.cs.ucsb.edu where you replace nn with the correct number.

If that doesn’t work for you, then consult the instructions below; you may have missed one of the set up steps.

Which Host?

You’ll need to know which Dokku server you were given access to. There will typically be a mapping from your team name to your Dokku instance such as the one below. Staff have access to the dokku-00.cs.ucsb.edu instance, and all other servers. Students typically have access to only one server, namely the one for their team.

Click the triangle to see the mappings. If your courses is not listed, see if your assignment materials have a link to the mapping for your course. If not, ask the instructional staff where to find it.

Spring 2023 (S23) team to Dokku mapping

Here is the mapping of teams to Dokku servers from S23:

Host	Team
dokku-00.cs.ucsb.edu	Course staff
dokku-01.cs.ucsb.edu	s23-5pm-1
dokku-02.cs.ucsb.edu	s23-5pm-2
dokku-03.cs.ucsb.edu	s23-5pm-3
dokku-04.cs.ucsb.edu	s23-5pm-4
dokku-05.cs.ucsb.edu	s23-6pm-1
dokku-06.cs.ucsb.edu	s23-6pm-2
dokku-07.cs.ucsb.edu	s23-6pm-3
dokku-08.cs.ucsb.edu	s23-6pm-4
dokku-09.cs.ucsb.edu	s23-7pm-1
dokku-10.cs.ucsb.edu	s23-7pm-2
dokku-11.cs.ucsb.edu	s23-7pm-3
dokku-12.cs.ucsb.edu	s23-7pm-4

Summer 2023 (M23) team to Dokku mapping

Here is the mapping of teams to Dokku servers from M23:

Host	Team
dokku-00.cs.ucsb.edu	Course staff
dokku-01.cs.ucsb.edu	m23-9am-1
dokku-02.cs.ucsb.edu	m23-9am-2
dokku-03.cs.ucsb.edu	m23-9am-3
dokku-04.cs.ucsb.edu	m23-10am-1
dokku-05.cs.ucsb.edu	m23-10am-2
dokku-06.cs.ucsb.edu	m23-10am-3
dokku-07.cs.ucsb.edu	m23-10am-4

SSH setup

There are three steps you need to do to get your account set up for access to Dokku:

1. Make sure your CSIL account has the following files in place:

   • ~/.ssh/id_rsa.pub (public key; may be freely shared with anyone)
   • ~/.ssh/id_rsa (private key; never share with anyone)

   If these files don’t exist in your account, you can run ssh-keygen at the CSIL shell prompt; just hit enter to accept all defaults. After running the ssh-keygen command, if you use the defaults, those files should then exist.

2. Type these two commands after you create your ssh public key:

   touch ~/.ssh/authorized_keys
   cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
   

   These commands allow you to login to any CSIL machine from any other without having to supply a password (more precisely, from any CSIL machine to another that mounts your same home directory) This is what will permit you to login to your dokku machine.

3. Try logging in with:

   ssh dokku-nn.cs.ucsb.edu where you replace nn with the correct number.

   If it still doesn’t work, ask for help

---