Instituto Superior Técnico

Serviços de Informática

Installing and configuring OpenAFS in Linux and Mac OS

In order to install OpenAFS in Linux, follow the steps described below.

  1. Install the packages openafs-krb5 and openafs-client:
    • >$ sudo apt install openafs-krb5 openafs-client (or other similar command)
  2. During the installation of the openafs-client package, fill AFS cell with
  3. To finish the installation, it is necessary to restart your computer.

In order to install OpenAFS in your MacOS, follow the steps described below.

  1. Go to and download the correct version of AFS for your MacOS.
  2. Agree with the end-user license agreement.
  3. Complete the product registration with the following:
    1. First Name: first name,
    2. Last Name: last name,
    3. Company/Organization: your Técnico’s email,
    4. AFS Cell Name: IST.UTL.PT.
  4. Find the installer and start the installation process.
  5. Follow the installation instructions presented to you. In one of the steps, you will have to enter the following:
    • Type in the name of your local cell:
  6. NOTE: If your computer has on ARM based CPU (Apple Silicon M1 or newer) you should follow these special instrucions available on Auristor website.

If you want to view the full detailed tutorial with screenshots, you can access the following tutorial.


Obtain an AFS token

The following instructions are valid for both Linux and Mac OS:

  1. The first step is to obtain a Kerberos ticket (instructions), by using the kinit command:
    • >$ kinit istxxxxx – where istxxxxx corresponds to your Técnico ID. Then, insert the respective password.
  2. To obtain an AFS token, we use the aklog command:
    • >$ aklog
  3. You can now confirm that you have the necessary AFS token, by using the tokens command:
    • >$ tokens

Access your personal area in the AFS system

After you have a valid AFS token, you can access your personal area in the AFS system, using the following command:

  • >$ cd /afs/, where:
    • a represents the second last number in your Técnico ID
    • y represents the last number in your Técnico ID
    • istxxxxay corresponds to  your Técnico ID