Part One
This tutorial has been designed for students at the University of Texas School of Information.
However, anyone may use this tutorial but will need to provide a proper hostname for to enter a non-UT School of Information server.
PINE is a secure, command prompt mail program that is easy to learn and manage.
To start PINE, you first have to open and log into a Secure Shell session. From your 'START' menu, navigate to your programs menu,
then to the 'SSH Secure Shell' prompt,
then click 'Secure Shell Client,' NOT 'Secure Shell Transfer Client.'
Now, login to Secure Shell using,with your username and your password.
After you complete the login process and receive the dollar sign prompt, just type "pine" and press return.
The bottom two lines of any PINE screen list commands you may execute.
The commands are preceded by a highlighted letter or symbol. To execute commands,
you should press the highlighted letter (on the keyboard of course). The commands for getting help and going back to the main menu are always present.
We are at the main menu so you do not see a main menu key.
Some of the command letters are preceded by an upside down "v", which is accessed by the Control symbol.
This means that you must press the Ctrl key and the highlighted letter in conjunction to execute the command.
Always look at the commands available at the bottom of the screen.
They will vary from place to place and indicate what functions you can perform at each point.

To view your mail:
After you log in and receive the Pine main menu, type "I" for Mail Index to see a list of your messages.
The highlighted line indicates which letter is subject to your key commands.
Any action you indicate by keying a command will be performed on the letter indicated by the highlighted line.
For example, "I" for message "L" for folder.
Now I am entering Message Index by typing "I."

To read a letter:
When a letter you want to read is highlighted at the mail index you can read it by pressing return.
Use your arrow keys to select the letter you want to read.
Then press "enter" or "return."
Now I am at the letter I selected.
To return to the Message Index simply type the left diamond "<" or comma key.

Replying to a letter:
You can reply to a letter when you are reading it or when it is highlighted in the Mail Index.
If you reply from the Mail Index you can read the letter and reply simultaneously.
To read and reply from the Mail Index simply select the letter you want to work with and type "R."
Pine will ask you if you want to include the original message in the reply.
Type Y for "yes" or N for "no."
The recipient and sender addresses will automatically be entered by Pine.
If you are replying to a list-serv or multi-address letter, Pine will ask if you want to reply to all recipients or only to the person who sent the letter.
Pine will also ask if you want to include the text of the letter in your reply.
You can answer these questions by typing Y for yes or N for no.
Now type the body of your letter.
When you are finished typing the letter you will send the letter by holding down the Control (Ctrl) key
and clicking the "x" key.
Pine will verify that you want to send the message and you type Y for Yes or N for no.
The letter will be sent and a copy will automatically be filed in your "sent mail" folder.

Composing a New Letter:
To create a letter, use the Compose command in any screen, and Pine will bring you to a mail template.
You will have to provide the e-mail address yourself, either by typing it in or using addresses stored in your address book.
Now simply type your message and then send the letter using the send command, which is holding the Control (Ctrl) key and clicking the "x" key.

Forwarding a Letter:
You can also forward a letter you have received to another address.
You may forward from the Message Index or while in an open letter.
In either location simply use the Forward command to forward a letter.
This will open the letter as a forward and then you enter the recipient address, any additional message and then use the send command to send the letter.

Working with Folders
Folders provide you with a way to keep your letters organized. Initially, you have three folders.
To access your folders go to Pine's main menu. From there, type "L" for Folder List.
You will now be at the folders area. To begin you will have "Inbox", "Sent-mail" and "Saved messages."
After you begin using Pine, a monthly "sent-mail ..." box will appear as well.
To navigate between folders use the keyboard arrow keys and highlight the folder you want to enter.
After you highlight the folder you want to enter, simply select the folder by clicking the "Enter" or "Return" button on your keyboard.
You can create other folders if these are not sufficient.
To create additional folders use the Add command by typing the letter "A" when you are in the folders area.
You will be prompted to name a new folder.
you can also Delete and Rename folders by using the associated command keys and following Pine's automatic prompting to choose the folders you want to delete or rename.

Address book:
When you receive mail, you can retrieve the address of the sender and place it in an address book by typing T for Take Address.
This will take you to the 'take address screen' where you will select which addresses you want to save.
Here you will use the arrow keys to select which address you want to save. When the desired address is highlighted, click 'Enter' or 'Return.'
Pine will ask you to select an easy nickname to remember for the address you are saving. Type in this nickname and then hit the 'Enter' or 'Return' key to save the address.
Now Pine will allow you to make any changes that are needed to the address and then you will click 'Ctrl' and 'X' to save the full entry and exit the address book function.
In the future, if you wish to write to that person again, you can use your Address book to retrieve the address into your mail template automatically by using a simple nickname.
The common list at the bottom of the screen will indicate how to proceed.

Deleting, Exporting, Attachments and Quitting Pine

To Delete:
You may mark a letter for deletion while in the Message Index or after you open the letter. From either location, simply use the Delete command.
This will mark the selected letter for deletion. To expunge the deleted letters type X. The number of letters selected for deletion will appear at the bottom of the Pine window.
Deleted letters can still be recovered before you quit Pine or expunge the system by use of the Undelete command when you are at a selected letter or by using the Yes or No command prior to expunging your mail.
When using the Undelete command Pine will inform you that you have undeleted a message.

Exporting Attachments
To view and/or export an attachment you first click the period or right diamond key when the letter is selected. Next you will chose S for Save or E for Export.
From this point Pine will direct you through where the file is being saved and you can find the file through your Secure Shell "Secure File Transfer" program or through Unix commands.
For more information on this ask the School of Information IT Services staff for assistance.


When you are composing a message or replying to a letter, you are can attach a file that you have in your School of Information account into your e-mail.
Click the Ctrl key and J and Pine will prompt you to give the name of the file which will be attached with your message.
This is a very useful feature as it allows you to create a long document or an image and forward it along to someone else via e-mail. Again, for more information please ask the IT Services at the School of Information for additional assistance.

Quitting Pine:

To leave Pine type Q for Quit. Pine will ask you to indicate if you still want to delete all the letters you have marked for deletion (if applicable) at this time.
You answer by typing Y for Yes or N for No.
Do not forget that quitting Pine does not log you out of you School of Information account.
To log out of your account completely, type exit at the dollar prompt after quitting Pine.

Thank you for viewing this tutorial. For more information please contact The University of Texas School of Information IT Services.